Spring Boot 配置加载优先级总结

优先级从高到低排列，高优先级覆盖低优先级的同名属性。

一、运行时参数（最高）

1. 命令行参数

java -jar app.jar --server.port=9090

2. JVM 系统属性

java -Dserver.port=9090 -jar app.jar

3. OS 环境变量

export SERVER_PORT=9090

二、外部配置文件（JAR 包外部）

按目录优先级从高到低：

./config/子目录/application-{profile}.yml
./config/子目录/application.yml
./config/application-{profile}.yml
./config/application.yml
./application-{profile}.yml
./application.yml

三、内部配置文件（JAR 包内部）

1. 项目自身的 src/main/resources/（即 classes/）

classpath:/config/application-{profile}.yml
classpath:/config/application.yml
classpath:/application-{profile}.yml
classpath:/application.yml

2. Maven 依赖 JAR 包中的同名文件

同名文件被项目自身的覆盖，多个依赖 JAR 之间顺序不可控。

四、代码级配置（最低）

1. @PropertySource 注解

@PropertySource("classpath:custom.properties")

2. SpringApplication.setDefaultProperties()

SpringApplication.setDefaultProperties(Map.of("server.port", "8080"));

五、同一层级内的子规则

六、Spring Cloud Bootstrap 阶段（如适用）

bootstrap-{profile}.yml > bootstrap.yml

• Bootstrap 阶段在 application 阶段之前执行
• bootstrap 中的属性会放入高优先级 PropertySource，一般不会被 application.yml 覆盖
• bootstrap 文件之间的优先级规则与 application 一致（外部 > 内部、profile > 通用、项目 > 依赖 JAR）

速记口诀

命令行 → JVM → 环境变量 → JAR外文件 → JAR内文件 → 注解 → 默认值

每一层内部：profile专属 > 通用，config/ > 根目录，项目自身 > 依赖JAR

排查手段

启动时加 --debug，或访问 Actuator 端点：

GET /actuator/env/{property.name}

可以看到每个属性在所有 PropertySource 中的值及最终生效来源。