[Spring] @ConfigurationProperties 서버 실행 오류

spring boot : 3.3.4

ConfigurationProperties로 프로퍼티를 private final 선언하고 서버 실행이 안되는 문제가 발생하여 정리해본다.

@ConfigurationProperties로 클래스에 프로퍼티를 바인딩하고
@ConfigurationPropertiesScan 을 사용해 프로퍼티가 바인딩된 클래스들을 스캔해서 빈으로 등록해주는데 신규 프로젝트 생성 후 인식을 하지못하는 문제가 발생하였다.

• 해결방법

1. Build, Executuion, Deployement -> Build Tools -> Gradle -> Build and run using ( Intellij IDEA -> Gradle 변경)
   

2. Build, Executuion, Deployement -> Compiler -> Java Compiler -> Additional command line parameters -> -parameters 추가 -> out 폴더 삭제 -> 재실행
   

해당 문제는 spring boot 3.2 전까지는 바이트코드를 파싱해서 매개변수 이름을 추론하려고 시도했지만 3.2 부터는 해당 동작을 수행하지 않도록 변경되어 발생하는 문제라고 한다.

참고 : https://docs.google.com/document/d/1j0jcJ9EoXMGzwAA2H0b9TOvRtpwlxI5Dtn3sRtuXQas/edit

https://github.com/spring-projects/spring-framework/wiki/Upgrading-to-Spring-Framework-6.x#parameter-name-retention