SpringBoot - 配置文件的优先级

本文详细阐述了SpringBoot项目中配置文件的加载顺序,包括命令行参数、JNDI属性、环境变量等不同来源,并强调了外部配置文件如何影响内部优先级。了解这些规则有助于确保配置的正确应用和可维护性。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

配置文件优先级:

(1)命令行参数;
(2)java:comp/env的JNDI属性;
(3)JAVA系统的环境属性;
(4)操作系统的环境变量;
(5)JAR包外部的application-XXX.properties或application-XXX.yml配置文件;
(6)JAR包内部的application-XXX.properties或application-XXX.yml配置文件;
(7)JAR包外部的application.properties或application.yml配置文件;
(8)JAR包内部的application.properties或application.yml配置文件;
(9)@Configuration注解类上的@PropertySource指定的配置文件;
(10)通过SpringApplication.setDefaultProperties 指定的默认属性;

项目外部配置文件:

(1)命令行参数:
在命令行中通过 java -jar 命令启动项目时,可以使用连续的两个减号 – 对配置文件中的属性值进行赋值,则命令行设置的属性会覆盖配置文件中属性的值。
java -jar xx.jar --server.port=8081,会覆盖配置文件中的端口。

(2)外置配置文件:
还可以指定配置文件的路径或者目录,则系统会使用指定的配置文件,或者目录下所有的配置文件。
java -jar xxx.jar --spring.config.location=/opt/servicex/config/application.yml
java -jar xxx.jar --spring.config.location=/opt/servicex/config/

项目内部配置文件:

(1)在同一级目录下(除后缀外其他部分都相同)配置文件的优先级:properties(最高) > yml > yaml(最低), 优先级高的配置会覆盖优先级低的配置。
(2)项目中优先级如下(从上往下优先级逐级降低,优先级高的配置会覆盖优先级低的配置)
项目名/config/XXX配置文件 (优先级最高)
项目名/XXX配置文件
项目名/src/main/resources/config/XXX配置文件
项目名/src/main/resources/XXX配置文件 (优先级最低)
在这里插入图片描述

servicex                 // 项目名
    |- servicex-auth     // 模块1
    |- servicex-system   // 模块2
        |- config        
            |- application.yml                // 1
        |- src
            |- main                  
                |- assembly          
                |- java              
                |- resources         
                    |- config        
                        |- application.yml    // 3
                    |- application.yml        // 4
            |- test             
        |- target
        |- application.yml                    // 2
        |- pom.xml  
    |- sql            
    |- doc           
    |- .gitignore     
    |- pom.xml        
    |- README.md      
External Libraries    

BOOTSTRAP配置文件

在 Spring Boot 中有两种上下文,一种是 bootstrap另外一种是 application, bootstrap 是应用程序的父上下文,bootstrap用于应用程序上下文的引导阶段,由父Spring ApplicationContext加载。bootstrap 的加载优先于 applicaton,所以优先级从大到小如下:
bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml

内外部优先级:

项目外部配置文件 > 项目内部配置文件

欢迎交流

请添加图片描述

### Spring Boot 配置文件加载顺序及优先级解析 Spring Boot配置文件加载机制是一个复杂而有序的过程,其设计目的是为了支持多种场景下的灵活配置管理。以下是关于配置文件加载顺序及其优先级的具体说明: #### 1. 加载位置 Spring Boot 支持多个不同位置的配置文件加载,这些位置包括但不限于以下几种[^1]: - **命令行参数**:这是最高优先级的配置来源之一。 - **Java 系统属性 (System.getProperties())**:可以通过 `-D` 参数传递给 JVM。 - **操作系统环境变量**:由操作系统的环境变量提供。 - **当前应用程序包外的 `config` 子目录中的配置文件**:位于运行 jar 文件同级目录下名为 `config` 的子目录中。 - **当前应用程序包内的 `config` 目录中的配置文件**:嵌套于 jar 包内部的 `config` 目录。 - **当前应用程序根目录中的配置文件**:直接放置在 jar 包的根路径下。 #### 2. 加载顺序 Spring Boot 应用启动时会遵循一定的顺序来查找并加载配置文件。具体来说,这个过程分为以下几个阶段[^2][^3]: - **外部化配置**:Spring Boot 将优先考虑外部化的配置资源,比如命令行参数、系统属性和环境变量等。 - **内置配置**:如果未找到外部化配置,则继续寻找内置的应用程序配置文件 (`application.properties` 或者 `application.yml`)。 具体的加载顺序如下: 1. 命令行参数。 2. 来自 Java 系统属性的属性。 3. 操作系统环境变量。 4. 当前应用程序所在目录的 `config/` 子目录中的配置文件。 5. 当前应用程序所在的目录中的配置文件。 6. classpath 中的 `/config/` 目录中的配置文件。 7. classpath 根目录中的配置文件。 #### 3. 优先级规则 配置项之间的冲突解决依赖于优先级规则。对于相同名称的配置项,较高优先级的配置将会覆盖较低优先级的配置[^5]。例如: - 如果某个配置既存在于命令行参数中也存在於 `application.properties` 文件中,那么命令行参数中的值将被采用。 - 自定义 Bean 对象通常具有更高的优先级,这意味着即使有自动装配的组件可用,开发者显式声明的 Bean 定义也会优先使用[^4]。 #### 4. 特殊情况处理 某些情况下可能还需要额外注意一些细节,例如: - 使用 Nacos 这样的分布式配置中心时,它的配置可能会进一步影响整体加载逻辑。 - 可以通过 `@PropertySource` 注解手动指定其他配置文件的位置,并将其纳入到 Spring 上下文中。 ```java // 示例代码展示如何利用 @PropertySource 添加额外配置源 @Configuration @PropertySource(value = "classpath:custom-config.properties", ignoreResourceNotFound = true) public class CustomConfig { // Configuration logic here... } ``` ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

cloneme01

谢谢您的支持与鼓励!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值