Spring Boot如何根据环境选配置文件？@active.profile@含义解析

一、Spring Boot 如何根据环境自动匹配配置文件 #

Spring Boot 对多环境配置有一套原生的规则，核心依赖命名约定和激活指定两个关键点：

• 配置文件命名规则：
  你项目里的application-{profile}.properties是标准的多环境配置命名格式，其中{profile}是自定义的环境标识（比如dev/qa/prod）。Spring Boot 会自动识别这类命名的文件，将其作为对应环境的专属配置。
• 激活指定环境：
  主配置文件application.properties中的spring.profiles.active用来指定当前要激活的环境标识。当这个值设为dev时，Spring Boot 会同时加载application.properties（公共配置）和application-dev.properties（dev环境专属配置），专属配置会覆盖公共配置里的重复项。
• 不同环境的激活方式：
  • 本地开发：可以在IDE运行配置里添加VM参数-Dspring.profiles.active=dev，或者临时修改application.properties里的值；
  • UAT/生产环境：可以通过启动命令指定（比如java -jar your-app.jar --spring.profiles.active=qa），或者设置系统环境变量SPRING_PROFILES_ACTIVE=prod，容器部署时也能通过环境变量注入的方式配置。

二、@active.profile@ 是什么含义 #

这是Maven 构建阶段的占位符，作用是在打包时动态替换spring.profiles.active的值：

1. 你需要在项目的pom.xml里定义对应的Maven Profile，每个Profile中设置active.profile属性，示例如下：

   <profiles>
       <profile>
           <id>dev</id>
           <properties>
               <active.profile>dev</active.profile>
           </properties>
       </profile>
       <profile>
           <id>qa</id>
           <properties>
               <active.profile>qa</active.profile>
           </properties>
       </profile>
       <profile>
           <id>prod</id>
           <properties>
               <active.profile>prod</active.profile>
           </properties>
       </profile>
   </profiles>
   

2. 执行Maven构建命令时，通过-P参数指定要激活的Maven Profile（比如mvn clean package -Pdev），Maven就会把application.properties里的@active.profile@替换成对应Profile中设置的属性值。打包完成后，application.properties里的spring.profiles.active就会变成dev/qa/prod，从而在不同环境运行时自动加载对应配置文件。

内容的提问来源于stack exchange，提问作者Abhishikth