Spring Boot 的配置文件加载优先级和合并机制分析

Spring Boot 的配置加载优先级和合并机制如下:

Spring Boot 配置加载优先级(从高到低)

1. 完整加载顺序

复制代码
1. file:./config/application.yml          ← 最高优先级
2. file:./application.yml                 
3. classpath:/config/application.yml      
4. classpath:/application.yml             ← JAR内部(最低优先级)

2. 具体说明

优先级 1:./config/application.yml(最高)
bash 复制代码
sample/target/
  ├── sample-1.10.0.jar
  └── config/
      └── application.yml  # ← 这个优先级最高
优先级 2:./application.yml
bash 复制代码
sample/target/
  ├── sample-1.10.0.jar
  └── application.yml  # ← 这个优先级第二
优先级 3:classpath:/config/application.yml

如果 JAR 内部有 BOOT-INF/classes/config/application.yml

优先级 4:classpath:/application.yml(最低)

JAR 内部的 BOOT-INF/classes/application.yml

配置合并机制

Spring Boot 会合并所有找到的配置文件,而不是完全替换:

示例说明

假设有以下配置:

JAR 内部的 application.yml:

yaml 复制代码
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/cloud_sample
    username: root
    password: root
  redis:
    host: localhost
    port: 6379

mqtt:
  BASIC:
    host: 192.168.1.100
    port: 1883
    username: JavaServer
    password: 123456

外部的 ./config/application.yml:

yaml 复制代码
spring:
  datasource:
    url: jdbc:mysql://prod-server:3306/cloud_sample  # 覆盖
    username: admin                                    # 覆盖
    # password 未配置,使用JAR内部的 root

mqtt:
  BASIC:
    host: 192.168.1.200  # 覆盖
    # port 未配置,使用JAR内部的 1883
    # username 未配置,使用JAR内部的 JavaServer

最终生效的配置:

yaml 复制代码
spring:
  datasource:
    url: jdbc:mysql://prod-server:3306/cloud_sample  # 来自外部
    username: admin                                    # 来自外部
    password: root                                     # 来自JAR内部

  redis:
    host: localhost                                    # 来自JAR内部
    port: 6379                                        # 来自JAR内部

mqtt:
  BASIC:
    host: 192.168.1.200                               # 来自外部
    port: 1883                                        # 来自JAR内部
    username: JavaServer                              # 来自JAR内部
    password: 123456                                  # 来自JAR内部

实际应用场景

场景 1:只覆盖部分配置

外部配置文件只需要包含需要修改的配置项:

yaml 复制代码
# ./config/application.yml
spring:
  datasource:
    druid:
      url: jdbc:mysql://prod-db:3306/cloud_sample
      username: prod_user
      password: prod_password

mqtt:
  BASIC:
    host: mqtt.prod.example.com
  DRC:
    host: ws-mqtt.prod.example.com

其他配置(如 Redis、JWT 等)会继续使用 JAR 内部的默认值。

场景 2:完全覆盖

如果需要完全覆盖某个配置块,需要完整定义:

yaml 复制代码
# ./config/application.yml
mqtt:
  BASIC:
    protocol: MQTT
    host: new-mqtt-server.com
    port: 1883
    username: new_user
    password: new_password
    client-id: new-client-id
    path: ""
  DRC:
    protocol: WS
    host: new-ws-server.com
    port: 8083
    path: /mqtt
    username: new_user
    password: new_password

验证配置加载顺序

启动应用时,可以通过日志查看加载的配置文件:

bash 复制代码
java -jar sample/target/sample-1.10.0.jar --debug

日志中会显示:

复制代码
The following profiles are active: 
Loaded config file 'file:./config/application.yml'
Loaded config file 'file:./application.yml'
Loaded config file 'classpath:/application.yml'

总结

  • 外部配置文件优先级更高:./config/application.yml > ./application.yml > JAR 内部配置
  • 配置会合并:外部配置覆盖相同键的值,未定义的键继续使用内部配置
  • 推荐做法:外部配置文件只包含需要修改的配置项,其他使用默认值

这样可以在不重新打包的情况下,灵活调整生产环境的配置。

相关推荐
码事漫谈7 小时前
# 2027年,AI终于要开始“干活”了
后端
小满zs8 小时前
Go语言第二十一章(Gin上传文件)
后端·go
兴趣互联8 小时前
jeecgboot nacos2.3.2 使用pgsql
java
hudd6689 小时前
JavaEE 初阶 - 文件操作和IO
java·开发语言·java-ee
JavaGuide10 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
Flynn Liang10 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
学长毕设10 小时前
基于SpringBoot社区快递驿站物流配送系统-附源码
java·spring boot·后端
Flynt10 小时前
Java4Shell 实测:EPYC 一跑就中招,关掉 Base64 硬件加速,1KB 解码慢 14 倍
java·安全·性能优化
Resean022311 小时前
Spring 源码分析(七)AOP 原理(上):代理的创建
java·后端·spring
Tangq一定可以的11 小时前
Spring AI Advisor 详解 - 给大模型调用加上“切面“,日志/过滤/记忆一键搞定
java·后端·spring