Spring Cloud AWS 3.x如何结合Spring Profiles使用SSM Parameter Store

问题背景 #

从Spring Boot 2.7.x + Spring Cloud AWS 2.4.x迁移到3.1.x + 3.0.2后，原有的SSM参数路径（如/my-app/some-fixed-part-{spring-profile}/my-parameter）无法像之前那样直接用${my-parameter}引用——导入后参数名变成了some-fixed-part-dev.my-parameter，且原2.x版本的name、profile-separator配置项已被移除。

解决方案 #

方法1：通过name-prefix-to-remove移除路径前缀 #

直接导入对应profile的参数路径，并指定要移除的完整前缀，让参数名只保留最后一段：

spring:
  config:
    # 用spring.profiles.active占位符自动替换环境名，导入对应环境的SSM参数路径
    import: "aws-parameterstore:/my-app/some-fixed-part-${spring.profiles.active}/"
  cloud:
    aws:
      paramstore:
        defaults:
          # 移除完整路径前缀，仅保留参数的最后一段作为键名
          name-prefix-to-remove: "/my-app/some-fixed-part-${spring.profiles.active}/"

激活dev环境时，导入路径为/my-app/some-fixed-part-dev/，配置会自动移除该前缀，/my-app/some-fixed-part-dev/my-parameter将被解析为my-parameter，直接用${my-parameter}即可引用。

方法2：使用导入路径的别名映射 #

在spring.config.import中通过?alias=/参数，将导入路径作为根路径，直接提取参数的最后一段作为键名：

spring:
  config:
    import: "aws-parameterstore:/my-app/some-fixed-part-${spring.profiles.active}/?alias=/"

该配置会忽略导入路径的层级，路径下所有参数都以最后一段名称作为键，效果与方法1一致。

原因说明 #

Spring Cloud AWS 3.x默认会将SSM参数的路径按层级转换为带点分隔的参数名（比如/a/b/c/param会被解析为a.b.c.param）。若仅导入/my-app/，/my-app/some-fixed-part-dev/my-parameter会被解析为some-fixed-part-dev.my-parameter；通过上述两种方法，我们可以直接定位到对应环境的子路径并移除前缀，让参数名回归原有的简洁形式。

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