ConfigurationProperties 2

Spring Boot에서 @ConfigurationProperties로 설정을 타입 안전하게 받기 (Value 남용 탈출)

@Value를 남용할 때 생기는 유지보수/검증 문제를 정리하고, Spring Boot 3의 @ConfigurationProperties + Validation로 설정을 타입 안전하게 분리하는 방법을 예제로 보여드립니다.도입 (문제 상황)@Value("${...}")를 여기저기 붙여서 설정을 읽다 보면, 어느 순간 “이 설정이 어디서 쓰이지?”를 추적하기가 꽤 힘들어집니다. 게다가 숫자/URL/시간 같은 값이 문자열로 흘러다니다가 런타임에야 터지는 경우도 자주 보게 됩니다. 설정을 타입 안전하게 받고, 검증까지 한 번에 묶어두는 방법이 필요합니다.핵심 개념 — Spring Boot @ConfigurationProperties가 중요한 이유Spring Boot에서 설정을 다루는 방식은 크게 두 가지로 나뉩니..

Spring Boot 2026.03.08

Spring Boot application.yml 설정 기본기 — properties vs yml, 계층 구조, 타입 바인딩까지

Spring Boot 3.x에서 application.yml을 제대로 쓰기 위한 기본기: properties와의 차이, 계층 구조 설계, @ConfigurationProperties 타입 바인딩, 설정 키 네이밍 팁을 실무 관점으로 정리합니다.1) 도입 (문제 상황)Spring Boot 프로젝트를 시작하면 가장 먼저 만지는 파일이 application.yml인데, 막상 설정이 늘어나면 “이 키를 어디에 둬야 하지?”, “점(.)으로 쓰는 게 맞나, 하이픈(-)이 맞나?” 같은 고민이 생기기 쉽습니다.또 @Value로 여기저기 주입하다가 타입 변환이나 기본값 처리에서 한 번쯤은 삐끗해 보셨을 거예요.2) 핵심 개념 (Spring Boot application.yml 설정을 잘 쓰는 이유)Spring Boo..

Spring Boot 2026.03.06