SpringBoot配置文件加载位置与优先级详解：从内部到外部的全景梳理

【1】项目内部配置文件

当 Spring Boot 应用启动时，默认会扫描以下四个位置的 application.properties 或 application.yml 文件作为主配置文件：

1. file:./config/（当前运行目录的子目录 config）
2. file:./（当前运行目录）
3. classpath:/config/（类路径下的 config 包）
4. classpath:/（类路径根目录）

这四个位置按照从上至下的顺序，优先级逐渐降低。Spring Boot 会依次加载所有存在的配置文件，若高优先级中的配置项与低优先级不冲突，则两者共存形成互补；若冲突，则高优先级值生效。

在实际部署中，若需改变默认配置的加载路径，可以通过 --spring.config.location 参数指定新的配置文件位置。例如：

java -jar spring-boot-02-config-02-0.0.1-SNAPSHOT.jar --spring.config.location=D:/application.properties

这种方式常用于将配置文件独立于 JAR 包之外，方便运维更新。

【2】外部配置加载顺序

Spring Boot 支持从多种外部来源加载配置。配置加载遵循“外部优先”原则，即外部的配置可以覆盖内部的配置。以下是详细的加载优先级从高到低的顺序：

第1步：命令行参数

这是最高优先级的配置方式。所有的配置项都可以通过命令行参数指定，多个配置项之间用空格分隔，格式为 --键=值。

例如修改服务端口和上下文路径：

java -jar spring-boot-02-config-02-0.0.1-SNAPSHOT.jar \
--server.port=8087 --server.context-path=/abc

第2步：来自 java:comp/env 的 JNDI 属性

从 JNDI 数据源中获取的属性值。

第3步：Java 系统属性

即调用 System.getProperties() 获取的系统属性。

第4步：操作系统环境变量

操作系统的 Environment Variables。在配置文件中，可以将大写下划线转换为驼峰命名来映射，例如环境变量 SERVER_PORT 对应配置 server.port。

第5步：RandomValuePropertySource

由 random.* 配置的随机属性值。

第6步：Jar 包外部的 Profile 特定文件

Jar 包外部的 application-{profile}.properties 或 application.yml（带有 spring.profiles.active 指定）。例如 application-dev.yml。

第7步：Jar 包内部的 Profile 特定文件

Jar 包内部的 application-{profile}.properties 或 application.yml。

第8步：Jar 包外部的通用文件

Jar 包外部的 application.properties 或 application.yml（不带 profile）。

第9步：Jar 包内部的通用文件

Jar 包内部的 application.properties 或 application.yml（不带 profile）。

这一部分的逻辑是：先加载 Jar 包外部的再加载内部的，且优先加载带 Profile 的文件，最后加载不带 Profile 的通用文件。

第10步：@Configuration 注解类上的 @PropertySource

显式指定的外部属性源。

第11步：SpringApplication.setDefaultProperties 指定的默认属性

通过代码 SpringApplication.setDefaultProperties 设置的最低优先级默认属性。

理解这些加载顺序对于调试复杂的微服务环境至关重要。建议在测试阶段使用命令行或环境变量快速切换配置，而在生产环境中保持配置文件的相对独立与安全。

以上就是 SpringBoot 配置文件加载位置与优先级问题的详细内容，更多关于 SpringBoot 配置文件加载优先级内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！