Spring Boot 多环境配置切换与加载优先级详解

实现多环境配置切换

在 Spring Boot 中，除了主配置文件 application.properties 或 application.yml 外，可以创建命名遵循 application-{profile}.properties 格式的额外配置文件，其中 {profile} 为自定义的环境标识（如 dev、product）。启动时通过激活特定 profile 来加载对应的配置。

第1步：创建环境专属配置文件

根据业务需求，在主资源目录下创建多个带后缀的配置文件。例如，为开发（dev）、产品/生产（product）、质量保证（qa）和阶段发布（stage）分别建立配置文件，同时保留默认的 application 文件用于存放所有环境共用的基础配置。

第2步：配置激活方式

在 application.properties 中通过 spring.profiles.active 指定当前生效的环境，主要有以下两种方式：

方法一：直接静态配置

直接在配置文件中写入目标环境标识，适用于单机调试或非构建依赖场景：

spring.profiles.active=dev

方法二：通过 Maven 进行动态替换（推荐用于打包部署）

为了实现一套代码在不同环境中打出的包自动包含对应配置，可使用 @spring.profiles.active@ 占位符，并在 pom.xml 中定义 Maven Profile 来替换该值。这样在本地开发时可保持默认，而在构建阶段切换环境。

首先，在 application.properties 中设置占位符：

spring.proprofiles.active=@spring.profiles.active@

其次，在 pom.xml 中添加 profiles 节点配置。通过 <activeByDefault> 标签指定本地默认的激活环境，并为其他环境定义相应的属性：

<profiles>
  <profile>
    <id>dev</id>
    <activation>
      <activeByDefault>true</activeByDefault>
    </activation>
    <properties>
      <spring.profiles.active>dev</spring.profiles.active>
    </properties>
  </profile>
  <profile>
    <id>qa</id>
    <properties>
      <spring.profiles.active>qa</spring.profiles.active>
    </properties>
  </profile>
  <profile>
    <id>stage</id>
    <properties>
      <spring.profiles.active>stage</spring.profiles.active>
    </properties>
  </profile>
  <profile>
    <id>product</id>
    <properties>
      <spring.profiles.active>product</spring.profiles.active>
    </properties>
  </profile>
</profiles>

执行 Maven 打包命令时，需携带 -P 参数指定环境 ID。此时，打包后的 jar/war 内部配置文件中的占位符将被替换为对应的环境值。注意，占位符名称必须与 pom.xml 中 <spring.profiles.active> 的定义完全一致，否则构建会报错。

Spring Boot 配置文件加载顺序

Spring Boot 严格按照特定路径搜索 application.properties 或 application.yml，其优先级从高到低决定了最终生效的配置值。理解这一顺序有助于解决配置冲突问题。

1. 外部配置优先级（由高到低）

• 项目运行目录下的 /config/ 子目录
• 项目运行根目录
• classpath 路径下的 /config/ 子目录
• classpath 根目录（即默认的 resources 目录）【优先级最低】

如果同一位置同时存在 application.yml 和 application.properties，则 .properties 文件的优先级高于 .yml（系统先加载 yml，后加载 properties，后者覆盖前者）。

总结而言，当存在同名配置项时，处于高优先级路径（如项目根目录）的配置将覆盖低优先级路径（如 classpath）的配置。实际开发中，建议将通用配置放在 classpath 内，而针对特定部署环境的敏感信息（如密码）优先放置在外部目录以便独立维护。