Spring Boot如何同时启用AWS SSM与多环境Profile配置并设置优先级

AWS SSM配置源和Spring Boot多环境Profile配置文件不存在二选一互斥的限制，你遇到的激活profile后SSM配置不加载的问题，是Spring Boot 2.4版本后配置加载机制变更、SSM配置源未按新规则导入导致的，按以下步骤配置即可实现你要求的从高到低的配置优先级：

1. SSM配置
2. 对应环境的application-{profile}.yml配置
3. 基础application.yml配置

1. 确认依赖版本匹配 #

你的技术栈为Spring Boot 2.6.6、JDK11，引入适配版本的SSM starter即可，无需额外引入bootstrap相关依赖：

<dependency>
    <groupId>io.awspring.cloud</groupId>
    <artifactId>spring-cloud-starter-aws-parameter-store-config</artifactId>
    <version>2.4.2</version>
</dependency>

注意：2.4.2是官方适配Spring Boot 2.6.x的稳定版本，不要使用3.x以上版本，3.x仅适配Spring Boot 3.0+。

2. 修改基础application.yml配置 #

放弃老版本的bootstrap上下文加载方式，使用Spring Boot 2.4+原生支持的spring.config.import机制导入SSM配置源，同时调整SSM配置源的优先级、开启多环境路径自动适配：

spring:
  config:
    # 导入SSM配置源，路径前缀根据你实际的SSM参数存储路径调整
    import: aws-parameterstore:/config/your-service-name/
  cloud:
    aws:
      parameterstore:
        enabled: true
        # 激活profile时自动拼接路径，例如激活dev时会自动读取/config/your-service-name/dev/下的参数
        profile-separator: '/'
        # 配置SSM配置源优先级，数值越小优先级越高，设为1确保优先级高于所有本地配置文件
        order: 1
      # 替换成你实际部署的AWS区域
      region:
        static: cn-north-1
  # 激活对应环境profile，该配置放在此处不会影响SSM加载
  profiles:
    active: dev

3. 本地profile配置文件注意事项 #

• 不要在application-dev.yml/application-qa.yml/application-prod.yml中覆盖spring.config.import配置，否则会覆盖基础配置中导入的SSM源，导致SSM配置失效
• 不要在profile配置文件中修改spring.cloud.aws.parameterstore相关的开关、优先级配置，避免加载顺序错乱

项目启动时添加启动参数--debug，在启动日志中搜索PropertySource列表，从上到下的顺序即为配置优先级从高到低，正常加载后顺序为：

• 对应环境路径下的SSM参数（如/config/your-service-name/dev/）
• 全局路径下的SSM参数（如/config/your-service-name/）
• 对应环境的application-{profile}.yml配置
• 基础application.yml配置

• 不要额外引入spring-cloud-starter-bootstrap依赖走老的bootstrap加载逻辑，Spring Boot 2.6.x默认禁用bootstrap上下文，强行启用会出现配置加载顺序混乱、部分配置源不加载的问题
• 确保运行环境的AWS凭证拥有SSM路径对应参数的ssm:GetParametersByPath权限，本地开发可通过~/.aws/credentials配置凭证，EC2/ECS/EKS环境可绑定对应权限的实例角色
• 若启动时提示SSM配置源导入失败，可在import路径前加optional:前缀（即import: optional:aws-parameterstore:/config/your-service-name/），本地无AWS环境时不会阻断项目启动

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