Jackson과 Inner Class, 직렬화할 땐 꼭 이걸 기억하세요!

 

 

Java에서 JSON을 다루려면 거의 필수처럼 따라오는 Jackson. 그런데 가끔 이렇게 생뚱맞은 에러 만나보신 적 없나요?

Cannot construct instance of ... non-static inner classes like this 
can only be instantiated using a default, no-argument constructor

 

 

“엥? 생성자도 있는데 왜 안 되지?”
이런 생각 들면, 아마 non-static inner class가 문제일 확률이 높아요.

---

🚨 왜 이런 일이 벌어질까요?

자바의 non-static inner class는 말 그대로 외부 클래스 인스턴스에 달라붙어 있는 클래스예요. 쉽게 말해서:

public class Outer {
    public class Inner {
        private String name;
    }
}

 

위처럼 만들면 new Outer().new Inner()처럼 외부 클래스 인스턴스가 있어야 내부 클래스를 만들 수 있어요.

그런데 문제는…
Jackson은 이걸 모른다는 것!
그냥 "Inner 클래스야? new Inner()" 이렇게만 시도하니까 에러가 나는 거죠.

---

✅ 해결법은 생각보다 간단해요!

1. static 붙이기! (가장 추천)

public class Outer {
    public class Inner {
        private String name;
    }
}

static을 붙이면 내부 클래스도 독립적으로 동작할 수 있는 일반 클래스처럼 변신합니다.
Jackson도 문제없이 직렬화/역직렬화 가능해요.
강력 추천!

---

2. 아예 클래스를 따로 빼기

public class Outer {
    public class Inner {
        private String name;
    }
}

이렇게 완전히 파일을 나눠서 작성해도 Jackson은 잘 알아먹습니다.
“나는 inner class 자체를 지양한다” 하신다면 이 방식도 좋아요.

---

3. 꼭 non-static 써야 한다면? @JsonCreator로 처리

public class Outer {
    public class Inner {
        private String name;

        @JsonCreator
        public Inner(@JsonProperty("name") String name) {
            this.name = name;
        }
    }
}

조금 복잡하지만, 꼭 필요한 경우 이렇게도 가능해요.
다만, Jackson 입장에서 꽤나 힘든 작업이 될 수 있으니 되도록 static 쓰는 게 속 편해요.

---

🔍 실제 예제로 볼까요?

❌ 문제가 되는 코드

@Data
public class MonitoringDeviceDTO {
    private String groupId;
    private String groupName;
    private List<MonitoringDevice> list;

    @Data
    public class MonitoringDevice {
        private String deviceId;
        private String deviceName;
    }
}

이 상태로 JSON을 역직렬화하면 위 에러가 그대로 발생합니다.

✅ 해결된 코드

@Data
public class MonitoringDeviceDTO {
    private String groupId;
    private String groupName;
    private List<MonitoringDevice> list;

    @Data
    public static class MonitoringDevice {
        private String deviceId;
        private String deviceName;
    }
}

static 한 줄로 Jackson이 행복해집니다.
우리도 에러 없이 개발할 수 있고요 😊

---

💡 몇 가지 팁!

• static inner class는 외부 클래스에 접근 못하지만, Jackson 입장에선 훨씬 다루기 쉬워요.
• Lombok의 @Data를 함께 쓰면 getter/setter/생성자까지 자동으로 챙겨주니 더 편합니다.
• 커스텀 로직이 필요한 경우엔 @JsonCreator, @JsonProperty, 커스텀 Serializer도 고려해보세요.

---

✨ 마무리하며

Jackson이랑 친하게 지내고 싶다면?
inner class엔 무조건 static 붙이기!
이것만 기억해도 많은 에러를 피할 수 있어요.

 

 

* 함께 보면 좋은 포스팅

2025.06.23 - [개발 일지 👩‍💻] - Jackson이란?

Jackson이란?

2025.06.23 - [개발 일지 👩‍💻] - static 클래스가 메모리에 항상 올라가 있나요?

static 클래스가 메모리에 항상 올라가 있나요?

 

 

 

#Java #Jackson #직렬화 #InnerClass #static #JSON #SpringBoot #백엔드개발 #Lombok #개발팁 #개발자로그