Spring Cloud AWS Secrets Manager 3.2.0 @Value值无法刷新问题咨询

在基于Spring Boot 3.2.10+的Kotlin项目中使用Spring Cloud AWS Secrets Manager Starter（版本3.2.0），启动时@Value注解的密钥能正常加载，但无法自动刷新。日志显示轮询已执行、检测到变更且上下文已重启，@PostConstruct也输出配置已重载，但@Value注入的值未更新。已经尝试@Configuration、@ConfigurationProperties与@RefreshScope的多种组合，寻求可用示例及解决方案。

依赖配置 #

<dependency>
    <groupId>io.awspring.cloud</groupId>
    <artifactId>spring-cloud-aws-starter-secrets-manager</artifactId>
    <version>3.2.0</version>
</dependency>

调试日志 #

2024-12-04 12:22:10,934 INFO  class=i.a.c.a.c.r.ConfigurationChangeDetector thread=spring-cloud-aws-secretsmanager-ThreadPoolTaskScheduler-1       description="Reloading using strategy: io.awspring.cloud.autoconfigure.config.reload.ConfigurationUpdateStrategy@1c04eb6a"
2024-12-04 12:22:10,974 INFO  class=o.s.boot.SpringApplication thread=spring-cloud-aws-secretsmanager-ThreadPoolTaskScheduler-1       description="The following 1 profile is active: "uat""
2024-12-04 12:22:10,976 INFO  class=o.s.boot.SpringApplication thread=spring-cloud-aws-secretsmanager-ThreadPoolTaskScheduler-1       description="Started application in 0.04 seconds (process running for 1091.236)"
2024-12-04 12:22:11,005 INFO  class=c.l.r.g.d.config.AppConfig$Companion thread=spring-cloud-aws-secretsmanager-ThreadPoolTaskScheduler-1       description="reloading secret post field -- thisisatestsecretfirstloadchange115"

application.yml配置 #

aws:
  secretsmanager:
    reload:
      strategy: refresh
      period: 1m
    region: us-east-1
    enabled: true
    endpoint: http://localhost:4566 

原AppConfig代码 #

@Configuration
@ConfigurationProperties
open class AppConfig: SecretsManagerConfig() {

    @Value("\${testing.password:}")
    @get:RefreshScope
    var testPasswordStringValue: String = ""
        get() = field
        set(value) {
            field = value
        }

    @PostConstruct
    open fun afterLoad() { 
        LOGGER.info("reloading secret post reload -- {}", this.testPasswordStringValue)
    }
}

解决方案及示例代码 #

核心问题分析 #

@Value本身不支持动态刷新，即便给字段加@RefreshScope也无法生效——@RefreshScope需要作用在类级别，或者配合@ConfigurationProperties的绑定逻辑实现动态更新，不能混用@Value和字段级的@RefreshScope。

正确实现方式 #

方式1：用@ConfigurationProperties替代@Value + 类级@RefreshScope

这是Spring Cloud推荐的动态配置刷新方案，无需依赖@Value：

@Configuration
@ConfigurationProperties(prefix = "testing")
@RefreshScope
open class AppConfig: SecretsManagerConfig() {
    // 自动映射配置中的testing.password，prefix指定配置前缀
    var password: String = ""

    @PostConstruct
    open fun afterLoad() { 
        LOGGER.info("reloading secret post reload -- {}", this.password)
    }
}

方式2：必须用@Value时，将@RefreshScope加在使用配置的Bean上

如果业务代码需要直接用@Value注入，要把@RefreshScope作用在消费配置的Bean类上，而非配置类的字段：

// 配置类仅负责加载配置，无需加@RefreshScope
@Configuration
open class AppConfig: SecretsManagerConfig() {
}

// 实际使用配置的业务Bean
@Service
@RefreshScope
open class SecretUsageService {
    @Value("\${testing.password:}")
    private lateinit var testPassword: String

    fun getCurrentPassword(): String {
        return testPassword
    }
}

配置注意事项 #

1. 确保aws.secretsmanager.reload.strategy保持为refresh（当前配置已正确）
2. 确认Secrets Manager中的密钥结构与配置映射匹配：如果密钥是JSON格式，字段名要和@ConfigurationProperties的属性名一致
3. 版本兼容性验证：Spring Boot 3.2.x与Spring Cloud AWS 3.2.x版本匹配，无需调整版本

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