news 2026/4/25 20:09:05

Spring Boot 配置文件核心用法与加载优先级

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Spring Boot 配置文件核心用法与加载优先级

一、多配置文件的核心用法

Spring Boot 采用「主配置文件 + 环境专属配置文件」的模式管理多环境配置,核心规则如下:

1. 配置文件命名规范

Spring Boot 默认识别.properties/.yml/.yaml两种格式,命名需遵循以下规则:

配置文件类型命名格式作用
主配置文件(必选)application.properties/application.yml存放所有环境的公共配置
环境专属配置文件application-{profile}.properties/application-{profile}.yml存放指定环境的专属配置(如application-dev.ymlapplication-prod.yml

2. 激活指定配置文件

支持 3 种激活方式,优先级从低到高排列:

方式 1:主配置文件中指定(最常用)

application.yml中通过spring.profiles.active激活,可指定多个环境(逗号分隔):

yaml

# application.yml(主配置文件) # 公共配置(所有环境生效) server: port: 8080 # 激活 dev 环境(可多环境:dev,test) spring: profiles: active: dev

示例环境配置文件:

yaml

# application-dev.yml(开发环境) spring: datasource: url: jdbc:mysql://localhost:3306/dev_db username: root password: 123456 logging: level: root: debug # 开发环境日志级别

yaml

# application-prod.yml(生产环境) spring: datasource: url: jdbc:mysql://192.168.1.100:3306/prod_db username: prod_user password: prod_123456 logging: level: root: info # 生产环境日志级别 server: port: 80 # 生产环境端口
方式 2:命令行参数指定(优先级更高)

打包为 jar 后,启动时通过--参数覆盖:

bash

运行

java -jar your-project.jar --spring.profiles.active=prod
方式 3:系统环境变量指定

设置系统环境变量SPRING_PROFILES_ACTIVE=test,Spring Boot 自动识别并激活 test 环境。

3. 进阶用法:多环境合并与分组

若配置按功能拆分(如数据库、Redis),可通过spring.profiles.include合并:

yaml

# application-dev.yml spring: profiles: include: - db-dev # 合并数据库配置(application-db-dev.yml) - redis-dev # 合并Redis配置(application-redis-dev.yml)

4. 实战目录结构

plaintext

src/main/resources/ ├── application.yml # 主配置(激活环境) ├── application-dev.yml # 开发环境核心配置 ├── application-prod.yml # 生产环境核心配置 ├── application-db-dev.yml # 开发环境数据库配置 └── application-db-prod.yml # 生产环境数据库配置

二、外部配置加载的核心规则

Spring Boot 加载配置遵循「后加载者优先」原则(后面的配置覆盖前面的),以下按优先级从低到高梳理:

1. 配置加载优先级(核心)

优先级加载位置说明
1(最低)classpath:/项目内部 src/main/resources 目录(默认位置)
2classpath:/config/项目内部 src/main/resources/config 目录
3./应用运行目录(jar 包所在目录)
4./config/应用运行目录下的 config 文件夹(生产环境最常用)
5./config/*/应用运行目录下 config 文件夹的子文件夹(按字母序加载)
6Java 系统属性(-D 参数)java -Dserver.port=8089 -jar app.jar
7操作系统环境变量SPRING_PROFILES_ACTIVE=prod(大写 + 下划线命名)
8命令行参数(-- 参数)java -jar app.jar --server.port=8083
9激活的 profile 配置文件如 application-prod.yml 覆盖 application.yml
10(最高)远程配置中心(Nacos/Apollo 等)覆盖所有本地配置

2. 实战验证示例

假设存在以下配置:

  • classpath:application.ymlserver.port=8080
  • ./config/application.ymlserver.port=8081
  • 启动命令:java -Dserver.port=8082 --server.port=8083 -jar your-app.jar

最终生效端口为8083,优先级顺序:命令行参数 > Java 系统属性 > 外部 config 配置 > 内部配置。

3. 实用技巧

  1. 生产环境:核心配置(数据库密码、端口)放在./config/application.yml,无需修改 jar 包即可调整;
  2. 临时调试:通过命令行参数快速切换环境,如--spring.profiles.active=test
  3. 避免冲突:远程配置中心只放核心业务配置,本地保留基础配置便于排查问题。

总结

多配置文件核心
  1. 命名规范:遵循application-{profile}.yml/properties,主配置存放公共配置;
  2. 激活方式:主配置文件指定为默认方式,命令行 / 环境变量可覆盖;
  3. 合并用法:通过spring.profiles.include拆分功能型配置文件。
配置加载核心
  1. 优先级规则:外部配置 > 内部配置,命令行 / 系统属性 > 环境变量 > 配置文件,远程配置 > 本地配置;
  2. 生产常用:./config/目录优先级高于项目内部 config,无需打包即可调整配置;
  3. 核心原则:后加载的配置会覆盖先加载的同名配置。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/25 15:53:37

人群仿真软件:Vadere_(6).Vadere中的障碍物设置

障碍物设置 在人群仿真软件Vadere中,障碍物的设置对于模拟真实环境中的各种情况至关重要。障碍物可以是墙壁、柱子、家具等,这些障碍物会影响行人的行走路径和行为。本节将详细介绍如何在Vadere中设置障碍物,包括障碍物的定义、添加、编辑和…

作者头像 李华
网站建设 2026/4/23 14:08:56

免费工艺流程模板下载_在线编辑建筑/汽车/物流工艺流程图图表

良功绘图网站 (https://www.lghuitu.com ) 在建筑、汽车、物流等行业的日常运营与项目推进中,工艺流程可视化是提升效率、规范管理的核心手段。无论是建筑工程的施工管控、汽车制造的生产线优化,还是物流行业的仓储配送调度,一份清晰、规范的…

作者头像 李华
网站建设 2026/4/22 19:17:34

AI金融风控:智能反欺诈与个性化理财

一、AI金融风控的核心价值与行业背景 随着数字金融的快速迭代,金融欺诈手段呈现智能化、隐蔽化、团伙化趋势,传统风控模式面临严峻挑战。2023年某电商平台披露数据显示,全年因恶意刷单、账号盗刷等造成的损失超2.3亿元,某银行信用…

作者头像 李华
网站建设 2026/4/24 9:40:59

MCP与A2A深度解析:AI系统集成与智能体协作的未来之路

MCP与A2A是AI系统集成的两大关键协议。MCP解决AI安全调用工具与数据的问题,提供资源、工具和提示模板三大能力;A2A则规范智能体间的协作,通过任务、消息和产物等组件实现高效接力。它们共同构成AI系统的分层规范,将开发范式从&quo…

作者头像 李华
网站建设 2026/4/23 15:43:03

网络考试点下一步出错怎么办?试试这样做

场景:家中网络课学习完毕考试,遇到点下一步出错问题 解决方案:打开显示所有题号的面板,点击面板上的题号跳转 注:我这里题号面板是点击进度条打开的,各人根据实际情况找下

作者头像 李华
网站建设 2026/4/23 17:57:50

抖店商品图如何保存到手机上的方法

抖音小店图片提取保存下载的方法如下: 方案一:借助傻瓜式工具【电商素材提取器】 打开抖音商城: 首先,打开抖音APP并进入“商城”页面。 找到所需商品并点击详情: 在商城中,浏览或搜索找到你希望提取图片…

作者头像 李华