Spring Boot JAR启动时配置文件加载顺序是怎样的？

Question

在Spring Boot应用以JAR方式启动时，配置文件的加载顺序常引发疑问：当同时存在项目内`application.yml`、JAR外部同级目录的`application.yml`、`application.properties`以及通过`--spring.config.location`指定的配置文件时，它们的优先级如何？哪些会覆盖哪些？尤其在多环境部署中，如何确保外部配置生效而不被内部默认配置覆盖？这一问题直接影响生产环境配置的正确性与灵活性。

Answer 1

Spring Boot应用JAR启动时配置文件加载顺序深度解析

1. 配置加载机制的初步理解

在Spring Boot中，配置文件的加载遵循“外部覆盖内部”的设计原则。当以JAR方式运行应用时，系统会自动扫描多个位置的application.yml或application.properties文件，并按优先级合并。

默认情况下，Spring Boot会从以下位置加载配置（按优先级由低到高）：

1. jar包内的classpath:/config/
2. jar包内的classpath:/
3. jar包外的./config/
4. jar包外的当前目录./

2. 多配置源共存时的优先级排序

当存在多个同名配置文件时，其加载顺序决定了最终生效的配置值。以下是典型场景下的优先级列表（从高到低）：

优先级	配置来源	说明
1	--spring.config.location指定路径	强制指定配置文件路径，最高优先级
2	JAR外部同级目录的application.yml	位于执行命令的当前目录
3	JAR外部./config/application.yml	相对路径config子目录
4	JAR内部classpath:/config/application.yml	打包在JAR中的配置
5	JAR内部classpath:application.yml	根路径下的内部配置
6	JAR外部application.properties	若存在，会被YAML覆盖（同级下）
7	JAR内部application.properties	最低优先级

3. 文件格式间的覆盖关系

Spring Boot支持.yml和.properties两种格式。在同一优先级目录下，若两者共存，则.yml优先于.properties被加载。例如：

# 目录结构如下：
.
├── application.yml
├── application.properties
└── myapp.jar

# 启动命令：
java -jar myapp.jar
    

此时，application.yml中的配置将覆盖同目录下的application.properties。

4. 使用--spring.config.location实现精确控制

该参数允许开发者显式指定配置文件路径，常用于生产环境部署。其语法支持单文件或多目录：

# 指定单一YAML文件
java -jar app.jar --spring.config.location=file:/opt/config/application-prod.yml

# 指定多个目录（逗号分隔）
java -jar app.jar --spring.config.location=classpath:/default/,file:/etc/myapp/
    

注意：使用此参数后，Spring Boot将不再自动扫描默认路径，必须确保指定路径包含所有必要配置。

5. 多环境部署中的最佳实践

为确保外部配置在生产环境中可靠生效，推荐以下策略：

• 避免在JAR内保留敏感信息（如数据库密码），仅保留默认值或开发环境配置。
• 使用spring.profiles.active结合外部配置激活特定环境：

# /etc/myapp/application-prod.yml
spring:
  profiles: prod
  datasource:
    url: jdbc:mysql://prod-db:3306/app
    username: prod_user
    password: ${DB_PASSWORD}
    

并通过启动命令注入：

java -jar app.jar \
  --spring.config.location=file:/etc/myapp/ \
  --spring.profiles.active=prod
    

6. 加载流程图解

以下是Spring Boot JAR启动时配置加载的整体流程：

graph TD
            A[启动应用] --> B{是否设置--spring.config.location?}
            B -->|是| C[加载指定路径配置]
            B -->|否| D[扫描默认位置]
            D --> E[jar内classpath:/config/]
            E --> F[jar内classpath:/]
            F --> G[jar外./config/]
            G --> H[jar外./]
            H --> I[合并所有配置]
            C --> I
            I --> J[应用最终配置]

7. 调试与验证配置加载行为

可通过启用调试日志查看实际加载的配置文件：

# application.yml
logging.level.org.springframework.boot.context.config=DEBUG
    

启动后可在日志中看到类似输出：

INFO  o.s.b.c.c.ConfigDataLocationResolverLog: Found local configuration file in the config directory [file:/app/config/application.yml]
DEBUG o.s.b.c.c.ConfigDataLoader: Loading config data from 'file:/app/config/application.yml'
    

此外，也可通过/actuator/env端点检查运行时生效的属性。

8. 容器化部署中的延伸考量

在Kubernetes等容器环境中，常通过ConfigMap挂载配置文件至固定路径，此时应结合--spring.config.location确保加载正确文件：

# Kubernetes Pod spec snippet
env:
- name: SPRING_CONFIG_LOCATION
  value: "file:/shared/config/application.yml"
volumeMounts:
- name: config-volume
  mountPath: /shared/config
    

这种模式实现了配置与镜像的完全解耦，提升部署灵活性。