
기본 설정 검색 위치에서 네 파일이 모두 로드되고 같은 키를 정의한다면, 우선순위가 가장 높은 JAR 외부의 프로파일별 파일 값이 적용됩니다. 외부 기본 파일은 JAR 내부의 프로파일별 파일보다도 우선합니다.
네 설정 파일의 우선순위
Spring Boot는 설정 데이터를 읽어 같은 키가 있으면 우선순위가 더 높은 값으로 덮어씁니다. 아래는 낮은 순위부터 높은 순위까지의 비교입니다.
- JAR 내부 기본 파일:
application.properties - JAR 내부 프로파일별 파일:
application-{profile}.properties - JAR 외부 기본 파일:
application.properties - JAR 외부 프로파일별 파일:
application-{profile}.properties
따라서 프로파일별 파일이라는 이유만으로 항상 기본 파일보다 높은 것은 아닙니다. 이 네 범주를 비교할 때는 외부 기본 파일이 내부 프로파일별 파일의 같은 키를 덮어씁니다. 어느 파일에 키가 없다면 해당 키는 더 낮은 순위에서 정의된 값을 사용할 수 있습니다.
네 파일에 같은 키가 있는 예제
다음 예제는 prod 프로파일이 활성화되어 있고, 기본 검색 위치에 네 파일이 있으며, 표시된 파일 외에 이 키를 덮어쓰는 설정이 없다고 가정합니다. 내부 파일은 JAR의 클래스패스 루트에, 외부 파일은 애플리케이션 실행 시 현재 디렉터리에 있습니다.
| 위치와 파일 | 내용 |
|---|---|
JAR 내부 application.properties |
service.label=jar-base |
JAR 내부 application-prod.properties |
service.label=jar-prod |
현재 디렉터리 application.properties |
service.label=external-base |
현재 디렉터리 application-prod.properties |
service.label=external-prod |
이 조건에서 service.label의 최종 값은 external-prod입니다. 외부 프로파일별 파일에서 이 키만 제거하면 그다음 우선순위인 외부 기본 파일의 external-base가 적용됩니다. prod가 활성화되지 않았다면 두 application-prod.properties 파일을 이 프로파일에 대한 후보로 계산해서는 안 됩니다.
예상과 다른 값을 판단할 때 확인할 조건
- 활성 프로파일: 여러 프로파일이 활성화되면 위치 그룹 수준에서 나중에 지정된 프로파일의 값이 앞선 값을 덮어쓸 수 있습니다. 활성 프로파일이 명시되지 않으면 기본적으로
default프로파일의 파일을 고려합니다. - 검색 위치: 외부 파일이 JAR 옆에 있다는 사실만으로는 충분하지 않습니다. 기본 검색 위치에는 현재 디렉터리와 그 아래
config/등이 포함됩니다.spring.config.location은 기본 위치를 대체하고, 추가 위치나 위치 그룹을 사용하면 비교 대상과 순서가 달라질 수 있습니다. - 다른 설정 소스: 이 순서는 네 설정 파일에 대한 것입니다. 환경변수, Java 시스템 프로퍼티, 명령행 인자 등 더 높은 우선순위의 소스도 최종 값을 바꿀 수 있습니다.
- 추가 설정과 파일 형식:
spring.config.import로 가져온 설정은 가져오기를 선언한 파일의 값을 덮어쓸 수 있습니다. 같은 위치에 properties와 YAML 파일이 함께 있으면 properties가 우선합니다.
실제 값을 따질 때는 먼저 활성 프로파일과 로드된 파일 위치를 확인하고, 해당 키가 있는 파일을 위 순서대로 비교한 뒤 다른 설정 소스의 덮어쓰기를 확인하세요. Actuator의 env와 configprops 엔드포인트도 원인 파악에 도움이 될 수 있지만, 사용하려면 접근과 노출 설정을 확인하고 민감한 정보가 공개되지 않도록 보호해야 합니다.