SpringBoot配置文件的加载顺序和优先级

配置文件加载与优先级解析
本文详细介绍了项目中配置文件的存放位置、读取顺序及优先级规则,包括不同目录下配置文件的加载顺序,以及同一配置属性在多个文件中配置时的处理方式。

1、配置文件的存放目录

 (1)file:./config/   
 	 当前项目目录下的一个/config子目录(工程根路径的config)
 (2)file:./
     当前项目目录(工程根路径)
 (3)classpath:/config
     项目的resources即一个classpath下的/config包
 (4)classpath:/
     项目的resources即classpath根路径(root)

2、配置文件的读取(加载)顺序

	(1)file:./config/  
	(2)file:./ 
	(3)classpath:/config 
	(4)classpath:/
	读取顺序由上往下。
	application.(后缀有properties、xml、yml、yaml)
	同名文件从左往右以依次读取。

3、配置文件的优先级

 	(1)file:./config/  
	(2)file:./ 
	(3)classpath:/config 
	(4)classpath:/
	优先级由上而下依次递减。

note:

(1)如果同一个目录下,有application.yml也有application.properties,默认先读取application.properties。
(2)如果同一个配置属性,在多个配置文件都配置了,默认使用第1个读取到的,后面读取的不覆盖前面读取到的。
(3)在工程根路径下(file:./)或者根路径的config(file:./config/)下面的配置文件,在工程打包时候不会被打包进去。
### Spring Boot 配置加载顺序优先级详解 Spring Boot 的配置加载机制基于外部化配置(Externalized Configuration),支持从多种来源加载配置属性,并按照明确的优先级顺序进行覆盖。以下是关于 Spring Boot 配置加载顺序优先级规则的详细说明: #### 1. 配置加载来源 Spring Boot 支持从以下来源加载配置属性,这些来源包括但不限于: - 命令行参数。 - 来自 `java:comp/env` 的 ServletConfig 环境。 - 系统环境变量。 - JVM 系统属性。 - 来自随机值的 `@Value("${random.*}")` 注解。 - 测试用例中的配置文件(如 `src/test/resources` 下的 `application.properties` 或 `application.yml`)。 - 开发者定义的 `@PropertySource` 中的配置文件。 - `bootstrap.yml` 或 `bootstrap.properties` 文件。 - `application.yml` 或 `application.properties` 文件。 - 包含在 jar 内部的默认配置文件。 #### 2. 配置加载优先级 Spring Boot 配置加载遵循以下优先级顺序(从高到低)[^1]: 1. **命令行参数**:通过 `--key=value` 格式指定的参数具有最高优先级。 2. **来自 `java:comp/env` 的 ServletConfig 环境**:Servlet 容器提供的环境变量。 3. **系统环境变量**:操作系统的环境变量。 4. **JVM 系统属性**:通过 `-D` 参数传递的 JVM 属性。 5. **随机值**:使用 `@Value("${random.*}")` 注解生成的随机值。 6. **测试用例中的配置文件**:如 `src/test/resources` 下的 `application.properties` 或 `application.yml`。 7. **开发者定义的 `@PropertySource` 配置文件**:通过注解显式加载的配置文件。 8. **`bootstrap.yml` 或 `bootstrap.properties` 文件**:用于早期加载的配置文件,通常用于云服务或加密密钥等场景[^3]。 9. **`application.yml` 或 `application.properties` 文件**:位于类路径根目录下的主配置文件。 10. **包含在 jar 内部的默认配置文件**:打包时嵌入的默认配置文件。 #### 3. 配置文件覆盖规则 当多个配置文件中存在相同的键名时,较高优先级配置文件会覆盖较低优先级配置文件中的值[^2]。例如: - 如果命令行参数中指定了 `server.port=8081`,那么即使 `application.yml` 中定义了 `server.port=8080`,最终生效的将是 `8081`。 - 如果 `application.yml` `application.properties` 同时存在,`application.yml` 的优先级更高。 #### 4. 示例代码 以下是一个简单的示例,展示如何通过不同方式设置 `server.port` 并观察其优先级: ```yaml # application.yml server: port: 8080 ``` ```properties # application.properties server.port=8080 ``` 运行命令: ```bash java -Dserver.port=8081 -jar app.jar --server.port=8082 ``` 最终生效的端口为 `8082`,因为命令行参数的优先级最高。 ---
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值