SpringBoot使用spring.config.import无法读取AWS参数存储值求助

在Spring Boot 3.1.1应用中，尝试通过spring.config.import从AWS Parameter Store导入配置，但无法在服务类中访问导入的值。

AWS Parameter Store中的参数 #

/config/my-project/preset/onboarding = app,scan,shop
/config/my-project/preset/onload = redeem,notification

application.yml配置 #

spring:
  config:
    import:
      - "optional:aws-parameterstore:/config/my-project/preset"

服务类代码 #

import org.springframework.core.env.Environment;

@Component
public class DataService {

    @Autowired
    private Environment env;

    public MemberData getPresetData(final String preset) {
        
        log.info("preset => " + preset);         /* preset = onboarding */

        String fields = env.getProperty(preset);
        
        log.info("fields => " + fields);         /* fields 输出为 null */
   
        String fields = env.getProperty("/config/my-project/preset/onboarding");
        
        log.info("fields => " + fields);         /* fields 输出为 null */
    }
}

build.gradle依赖 #

springboot version 3.1.1

implementation 'org.springframework.cloud:spring-cloud-starter-bootstrap:4.0.3'
implementation 'io.awspring.cloud:spring-cloud-aws-starter-parameter-store:3.0.1'
implementation 'io.awspring.cloud:spring-cloud-aws-starter-secrets-manager:3.0.1'

以下是排查和解决该问题的关键步骤：

1. 确认属性名称的正确映射 #

Spring Cloud AWS Parameter Store导入参数时，会自动将路径格式转换为点分隔的属性名，并去掉你指定的导入根路径：

• 你导入的根路径是/config/my-project/preset，原参数/config/my-project/preset/onboarding对应的属性名应为onboarding
• 直接用原路径获取会失败，因为Spring已完成路径转换

如果上述方式无效，可添加spring.application.name配置（与参数路径中的项目名一致），再通过preset.onboarding获取：

# application.yml中新增
spring:
  application:
    name: my-project

// 服务类中尝试
String fields = env.getProperty("preset.onboarding");

2. 显式启用Bootstrap上下文 #

Spring Boot 3.x默认禁用Bootstrap上下文，即使引入了spring-cloud-starter-bootstrap，也建议显式启用确保生效：

spring:
  cloud:
    bootstrap:
      enabled: true

3. 验证AWS权限 #

应用运行环境（EC2/ECS角色、本地AWS凭证）必须具备访问目标Parameter Store参数的权限，所需IAM权限示例：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ssm:GetParametersByPath",
        "ssm:GetParameter",
        "ssm:DescribeParameters"
      ],
      "Resource": "arn:aws:ssm:你的AWS区域:你的AWS账号ID:parameter/config/my-project/preset/*"
    }
  ]
}

本地运行时，确保AWS CLI已配置有权限的凭证。

4. 排查配置加载过程 #

开启Debug日志，查看Spring是否成功加载了Parameter Store的参数：

logging:
  level:
    io.awspring.cloud.parameterstore: DEBUG
    org.springframework.cloud.config: DEBUG

启动应用后，检查日志中是否有类似Loaded parameter from AWS Parameter Store: /config/my-project/preset/onboarding的记录，确认配置是否导入成功。

5. 移除optional前缀（调试阶段） #

暂时去掉optional:前缀，若配置导入失败，Spring会直接抛出异常，快速定位问题：

spring:
  config:
    import:
      - "aws-parameterstore:/config/my-project/preset"

若启动时抛出权限不足或参数不存在的异常，即可针对性解决。

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