Spring Boot 버전업 중 Java 모듈 시스템 변화와 캡슐화 정책 강화

이 게시물은 Spring Boot와 Java 버전업 과정에서 발생한 Gson 직렬화 문제를 분석하며 Java 모듈 시스템의 변화와 캡슐화 정책 강화에 대해 설명합니다.

주요 내용

• Java 9부터 17까지 모듈 시스템 도입과 점진적 강화
• Java 17에서 JEP 403 적용으로 내부 API에 대한 강력한 캡슐화 시행
• 리플렉션을 통한 private 필드 접근 제한으로 Gson 직렬화 오류 발생
• Custom TypeAdapter 작성으로 문제를 우회하고 직렬화 문제 해결

Gson 직렬화 동작 원리

• ReflectiveTypeAdapterFactory가 리플렉션으로 객체 필드 접근
• Java 17 강화된 모듈 시스템으로 인해 리플렉션 접근 불가
• Custom TypeAdapter 등록 시 기본 리플렉션 방식을 대체 가능

결론

문제의 근본 원인인 Java 모듈 시스템의 변화 이해를 통해 안정적인 직렬화 방법을 확보하였으며, 향후 유사 문제 대응에 도움이 되는 통찰을 제공한다.