Spring Boot 配置文件生效规则

Spring Boot 配置文件生效规则

本文档整理了 Spring Boot 配置文件的加载顺序与优先级规则,包括项目内、项目外及多环境配置的管理方式。

1. 通用优先级规则(从高到低)

Spring Boot 中,配置优先级顺序如下(高优先级会覆盖低优先级):

  1. 命令行参数--server.port=8081
  2. JNDI属性 :来自 java:comp/env
  3. Java系统属性-Dserver.port=8081
  4. 操作系统环境变量
  5. 配置文件application.properties / application.yml),按以下位置顺序加载:
    • 当前目录下的 /config 子目录
    • 当前目录
    • classpath 下的 /config
    • classpath 根路径
  6. Profile 专用文件application-{profile}.properties/yml
  7. 默认属性SpringApplication.setDefaultProperties

2. 项目外配置文件规则

适用场景:不重新打包 JAR 的情况下修改配置。

优先级顺序(从高到低)

优先级 位置(相对于 JAR 包运行目录) 说明
最高 ./config/ JAR 同级目录下的 config 文件夹,推荐生产环境使用
./ JAR 同级目录
classpath:/config/ JAR 包内部 config 包(即 resources/config
最低 classpath:/ JAR 包内部根路径(即 resources 根目录)

高优先级配置会覆盖低优先级配置,不同位置配置互补合并。

完全自定义配置文件位置

使用 --spring.config.location 强制指定外部配置目录(此时内部配置不再生效):

bash 复制代码
java -jar my-app.jar --spring.config.location=file:/绝对路径/配置文件夹/application.properties
相关推荐
IT_陈寒44 分钟前
Vite热更新失灵?你可能漏了这个配置
前端·人工智能·后端
Ramble_Naylor1 小时前
东方通(TongWeb)SpringBoot开发指导
java·spring boot
uzong1 小时前
面试官:如何做好架构设计
后端·架构
Cosolar1 小时前
QwenPaw Agent 实现原理深度剖析
后端·面试·架构
JacksonMx2 小时前
@Transactional 最佳实践
java·spring boot·spring·性能优化
Sincerelyplz2 小时前
【AI会议纪要实践】mapReduce、RAG 与结构化输出
java·后端·agent
zavoryn2 小时前
后端接入 AI Agent:Tool Calling 网关、幂等与审计日志实战
后端·架构
swipe3 小时前
混合检索 RAG 的工程化实践:不是多查几路,而是把召回、重排和上下文预算管好
后端·langchain·llm
uzong3 小时前
分布式下的系统,什么是算是好的架构设计
后端·架构
金銀銅鐵4 小时前
[Java] 如何理解 class 文件中方法的 access flags?
java·后端