Spring Boot 的系统配置文件加载顺序

本文介绍了Spring Boot系统配置文件的加载顺序,从优先级最高的项目根目录下的config目录开始,依次是项目根目录、classpath下的config目录,到优先级最低的classpath目录。加载时遵循4->3->2->1的顺序,且高优先级的配置会覆盖低优先级的相同属性。文章还给出了项目结构示例和启动命令示例,帮助读者理解配置文件的使用和覆盖规则。

【理论介绍】

配置文件加载顺序:

1、项目根目录下的config目录。【优先级最高】
2、项目根目录。
3、classpath下的config目录。
4、classpath目录(新建项目时application.properties默认所在位置)。【优先级最低】

备注:
加载顺序:4 -> 3 -> 2 -> 1。
优先级:逐渐减低(1>2>3>4)。

 


【举例说明】

项目结构示例:

ad1996a2d8a64364a70ad798ed8ca148.png

1、项目根目录下的config目录(file:./config/):helloworld/config/
2、项目根目录(file:./):helloworld/
3、classpath下的config目录(classpath:/config/):helloworld/src/main/resources/config/
4、classpath目录(classpath:/):helloworld/src/main/resources/

 

启动命令

java -jar helloworld-0.0.1-SNAPSHOT.jar

指定配置文件的启动命令

java -jar helloworld-0.0.1-SNAPSHOT.jar --spring.config.location=classpath:/application.properties

 

扩展:

(1)指定配置文件名称(如指定配置文件为helloworldApplication.properties):

$ java -jar helloworld-0.0.1-SNAPSHOT.jar --spring.config.name=helloworldApplication

(2)指定两个配置文件,后一个覆盖前一个中相同的属性项(前后两个文件都有的属性项,覆盖前一个属性项,使用后一个属性项;前一个有而后一个没有的属性项,使用前一个的属性项):

$ java -jar helloworld-0.0.1-SNAPSHOT.jar --spring.config.location=classpath:/default.properties,classpath:/override.properties

【参考来源】

 官网:24. Externalized Configuration

c21acc166c1340c9a7d8adffb71ae5bf.png

 

 

### Spring Boot 配置文件加载顺序 Spring Boot配置文件加载机制遵循一定的优先级规则,这些规则决定了哪些配置会覆盖其他配置。以下是关于 Spring Boot 配置文件加载顺序的详细介绍: #### 默认配置文件加载顺序 Spring Boot 使用 `ConfigFileApplicationListener` 来处理外部化配置文件加载过程。默认情况下,它按照以下顺序加载配置文件[^1]: 1. **命令行参数 (Command Line Arguments)** 命令行参数具有最高优先级,可以覆盖任何其他地方定义的属性。 2. **来自 Java System Properties 的属性** 这些可以通过 `-Dproperty=value` 形式传递给 JVM。 3. **操作系统环境变量** 环境变量也可以作为配置的一部分被读取。 4. **随机数生成器中的 random.* 属性** 如果应用程序需要一些动态生成的值(如端口),可以从这里获取。 5. **servlet-config 和 servlet-context 初始化参数** 当运行于 Servlet 容器中时,初始化参数会被考虑进来。 6. **JNDI 属性 (java:comp/env/)** JNDI 提供了一种标准的方式来访问企业级别的资源和服务。 7. **Java 资源路径下的 application.properties 或者 application.yml 文件** 包括 classpath:/, classpath:/config/, file:./, file:./config/ 中的内容都会被扫描并应用。 8. **打包 jar 外部的应用程序包外的 profile-specific properties 文件** 例如:application-dev.properties。 9. **打包 jar 内部的应用程序包内的 profile-specific properties 文件** 同样支持基于不同 profiles 的定制化设置。 10. **打包 jar 外部的应用程序包外的基础 properties 文件** 如 application.properties 或 application.yml。 11. **打包 jar 内部的应用程序包内的基础 properties 文件** 即位于 resources 下的标准配置文件。 上述列表展示了从高到低的不同层次上的配置来源及其相对应的作用范围和影响程度[^3]。 #### 自定义 MyBatis 配置的影响 如果项目引入了 MyBatis 并通过其自动配置功能,则可能会涉及到额外的自定义配置项。比如,在 org.mybatis.spring.boot.autoconfigure.MybatisProperties 类中定义了一些特定的关键字用于描述数据库连接池大小、SQL 映射位置等细节[^2]。这类扩展不会改变整体框架对于全局配置文件解析逻辑的行为模式,但它确实增加了局部领域内可调整选项的数量。 ```yaml mybatis: config-location: classpath:mybatis/mybatis-config.xml mapper-locations: classpath:mappers/**/*.xml ``` 以上是一个典型的 YAML 片段例子展示如何指定 MyBatis XML 文件的位置以及主配置文档地址。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值