Spring profiles group配置加载问题及多环境配置正确实现方案咨询

问题根因 #

你配置中的default是自定义的profile分组名，和Spring Boot默认的激活规则是两个独立逻辑：默认情况下未指定启动profile时，Spring只会激活名为default的单profile，不会自动匹配同名的profile分组，所以你定义的default分组不会被触发加载。

正确配置方案 #

只需要在通用配置块中追加spring.profiles.default属性，指定默认激活的profile为你自定义的default分组名即可，完整配置结构如下：

# 通用配置块（所有场景优先加载）
spring:
  # 通用配置项写在这里
  profiles:
    # 指定未指定启动profile时，默认激活的profile为自定义的default分组
    default: default
    # profile分组定义
    group:
      default:
        - prod
        - actuator
      dev:
        - dev
        - actuatorDev
      uat:
        - uat
        - actuatorUat

---
# prod环境专属配置
spring:
  config:
    activate:
      on-profile: prod
# prod专属配置项写在这里

---
# 生产环境actuator配置
spring:
  config:
    activate:
      on-profile: actuator
# 生产环境actuator配置项写在这里

---
# dev环境专属配置
spring:
  config:
    activate:
      on-profile: dev
# dev专属配置项写在这里

---
# dev环境actuator配置
spring:
  config:
    activate:
      on-profile: actuatorDev
# dev环境actuator配置项写在这里

---
# uat环境专属配置
spring:
  config:
    activate:
      on-profile: uat
# uat专属配置项写在这里

---
# uat环境actuator配置
spring:
  config:
    activate:
      on-profile: actuatorUat
# uat环境actuator配置项写在这里

逻辑验证 #

• 未指定启动profile时：自动激活default分组，加载顺序为「通用配置 → prod配置 → actuator配置」，符合默认启用生产环境的需求
• 启动指定--spring.profiles.active=dev时：激活dev分组，加载顺序为「通用配置 → dev配置 → actuatorDev配置」，和你之前的正常逻辑一致
• 启动指定--spring.profiles.active=uat时：激活uat分组，加载顺序为「通用配置 → uat配置 → actuatorUat配置」

注意事项 #

• profile分组的定义必须放在无激活条件的通用配置块中，不能放在绑定了特定profile的配置块里，否则未激活对应profile时会读不到分组配置
• 该特性仅支持Spring Boot 2.4及以上版本，低版本需要先升级依赖

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