如何在Maven构建的Spring Boot Docker镜像运行时激活指定Profile

核心原理 #

Spring Boot原生支持通过环境变量SPRING_PROFILES_ACTIVE指定激活的Profile，优先级高于构建时的默认配置。Cloud Native Buildpacks构建的镜像会自动传递容器环境变量到应用进程，无需修改入口命令/cnb/process/web。

步骤1：在pom.xml中配置默认激活的Profile #

通过spring-boot-maven-plugin的image.env配置，给镜像设置默认的激活Profile（比如默认用IST环境），这样镜像在无额外参数时会使用该默认值：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <image>
            <env>
                <!-- 设置默认激活的Profile -->
                <SPRING_PROFILES_ACTIVE>IST</SPRING_PROFILES_ACTIVE>
            </env>
        </image>
    </configuration>
</plugin>

执行mvn spring-boot:build-image构建镜像后，默认会激活IST环境的配置。

步骤2：运行镜像时通过docker run覆盖Profile #

启动容器时，用-e参数指定SPRING_PROFILES_ACTIVE变量，即可覆盖镜像中的默认值，切换到目标环境：

# 切换到UAT环境
docker run -e SPRING_PROFILES_ACTIVE=UAT your-image-tag

# 切换到PROD环境
docker run -e SPRING_PROFILES_ACTIVE=PROD your-image-tag

验证配置有效性 #

确保你的application.yml中已正确定义各环境的Profile配置，示例结构如下：

# 全局通用配置
server:
  port: 8080

---
# IST环境专属配置
spring:
  config:
    activate:
      on-profile: IST
server:
  port: 8081
# 其他IST环境变量，如数据库地址等

---
# UAT环境专属配置
spring:
  config:
    activate:
      on-profile: UAT
server:
  port: 8082
# 其他UAT环境变量

---
# PROD环境专属配置
spring:
  config:
    activate:
      on-profile: PROD
server:
  port: 80
# 其他PROD环境变量

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