news 2026/6/15 18:35:37

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/6/7 21:20:14

数据结构01——时间复杂度和空间复杂度

一.什么是数据结构数据结构(Data Structure)是计算机存储、组织数据的方式,指相互之间存在⼀种或多种特定关系的数据集合。不存在一种通用的数据结构针对于所有应用场景,所以产生了多种多样的数据结构来适配不同的环境:例如顺序表、链表、堆栈…

作者头像 李华
网站建设 2026/6/15 14:22:21

彼得林奇的“反向投资“成功案例

彼得林奇的“反向投资”成功案例 关键词:彼得林奇、反向投资、成功案例、投资策略、股票分析 摘要:本文聚焦于彼得林奇的“反向投资”策略及其成功案例。首先介绍了彼得林奇及其反向投资策略的背景,阐述了相关核心概念和联系。接着详细讲解了…

作者头像 李华
网站建设 2026/6/10 17:32:15

企业AI开发与技术实践白皮书2025|附36页PDF文件下载

白皮书探讨了在GenAI时代,企业如何利用大模型技术实现智能化转型。白皮书指出,大模型能力的不断提升为企业带来了无限想象力,但也面临着战略规划、数据治理、算力资源、场景适配等方面的挑战。企业需要构建覆盖顶层设计、技术选型、数据治理、…

作者头像 李华
网站建设 2026/6/15 9:16:48

【Java 新手必看】比较运算符:从概念到实战,附可运行代码案例

比较运算符是 Java 中用于判断 “两个值 / 变量关系” 的核心运算符,也是实现程序逻辑判断(如 if/else)的基础。新手常混淆 “等于” 和 “赋值”、“等于” 和 “对象相等”,这篇笔记结合可直接运行的代码案例,从基础…

作者头像 李华