Spring Boot 多环境配置与文件优先级详解

一、多环境配置实现方式

项目开发过程中，数据库地址、端口号等配置往往随环境变化而调整。硬编码切换不仅繁琐且易出错。Spring Boot 支持通过激活不同的 Profile 来隔离配置，只需修改一处激活标记即可完成环境切换。

第1步：使用 YAML 文件配置多环境

目的：在单一 application.yml 文件中集中管理多个环境的配置项。
操作：利用 --- 作为分隔符划分不同的配置块，并为每个块指定唯一的 profile 名称。

#默认通用配置
spring:
  profiles:
    active: dev #当前激活的环境标识

---
#开发环境配置块
spring:
  config:
    activate:
      on-profile: dev
server:
  port: 80

---
#生产环境配置块
spring:
  config:
    activate:
      on-profile: pro
server:
  port: 81

---
#测试环境配置块
spring:
  config:
    activate:
      on-profile: test
server:
  port: 82

注意：旧版本的 spring.profilesspring.config.activate.on-profile 进行声明。

第2步：使用 Properties 文件配置多环境

目的：为每种环境创建独立的配置文件，保持文件结构清晰。
操作：建立以 application-{profile}.properties 格式命名的文件存放特定配置。

• 开发配置：application-dev.properties
• 测试配置：application-test.properties
• 生产配置：application-pro.properties

在主配置文件 application.properties 中指明当前要激活的配置文件：

spring.profiles.active=pro

第3步：使用命令行参数动态切换

目的：在不修改源码和配置文件的情况下，启动时通过命令控制运行环境与参数。
操作：在打包为 JAR 包后，使用 Java 命令启动时追加参数。

常用指令示例：

• 仅切换环境：java -jar xxx.jar --spring.profiles.active=test
• 临时覆盖端口：java -jar xxx.jar --server.port=88
• 组合参数启动：java -jar springboot.jar --server.port=88 --spring.profiles.active=test

命令行参数的优先级高于常规配置文件中的设置。关于完整的优先级列表可参考 Spring Boot 官方文档（见 ），高优先级配置将覆盖低优先级同名参数。

二、配置文件分类与优先级验证

当测试人员介入验证时，可能需要针对特定环境临时修改大量参数。为避免频繁改动源码内文件，Spring Boot 允许将配置文件置于类路径外的特定目录，从而实现外部化配置管理。

第4步：构建工程验证加载优先级

入口：创建一个名为 springboot_06_config_file 的基础 Spring Boot 项目（）。
动作：分别在 resources/ 和 resources/config/ 目录下放置不同端口号的配置文件进行测试。

经实测，当存在同名配置文件时，config 子目录下的配置优先级高于根目录 resources 内的配置。

第5步：验证类路径外配置加载规则

准备：执行 Maven package 插件生成最终 JAR 文件（）。

动作：在 JAR 包同级目录下新建 config/application.yml，并写入更高优先级的参数（如设置端口为 82）。

运行该 JAR 包后日志显示已正确加载外部文件。这证明位于 Jar 包所在位置的 ./config 目录拥有比内部资源更高的读写优先级。若需设置全局系统级通用属性，还可将文件放在 ./target/config 下。

注意：Spring Boot 2.5.0 版本曾因目录检测逻辑存在 Bug 导致无法自动识别空 config 目录，建议使用时留意版本修复情况或在该目录下放置任意占位文件夹以确保兼容性。

以上就是 Spring Boot 多环境配置及配置文件优先级规则的详细内容，更多关于 Spring Boot 环境隔离的资料请关注本站其它相关文章！