使用Spring Cloud Vault时调用actuator/refresh未更新@Value变量问题

核心原因1：缺少@RefreshScope注解 #

@Value注入的属性仅在Spring容器初始化时赋值一次，默认不会动态更新。要让属性在调用actuator/refresh接口后更新，必须在持有@Value的Bean上添加@RefreshScope注解。该注解会将Bean纳入Spring Cloud的刷新管理范围，刷新触发后会销毁旧的Bean实例，下次请求时重新创建并注入最新属性值。

修复代码： #

@RestController
@RefreshScope // 新增该注解
public class ErrorControllerImpl implements ErrorController {
    @Value("${gateway.prefix}")
    private String prefixPath;
    // 其余代码保持不变
}

核心原因2：自定义@VaultPropertySource不支持自动刷新 #

你在启动类上手动声明的@VaultPropertySource是Spring Vault原生注解，默认不会被Spring Cloud的刷新逻辑识别，调用refresh接口时不会主动拉取Vault最新配置。同时你配置了spring.cloud.vault.kv.enabled: false，关闭了Spring Cloud Vault默认提供的、支持自动刷新的KV属性源。

两种修复方案： #

• 方案1：移除启动类上的@VaultPropertySource注解，将spring.cloud.vault.kv.enabled改为true，同时配置KV路径为你需要的secret/services/${spring.application.name}/config，使用Spring Cloud Vault自动配置的可刷新属性源。
• 方案2：如果必须保留自定义@VaultPropertySource，需要自行实现刷新逻辑：监听RefreshScopeRefreshedEvent事件，事件触发时手动拉取Vault最新配置，更新Spring环境中的属性值。

其他可能的配置问题 #

确保你已正确开启refresh端点，在yml中添加以下配置：

management:
  endpoints:
    web:
      exposure:
        include: refresh
  endpoint:
    refresh:
      enabled: true

调用refresh接口时需使用POST请求，请求地址为/actuator/refresh，调用后返回的响应数组中如果包含gateway.prefix，说明属性已经成功同步到Spring环境中。

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