Spring Boot 3.0.0中@Value注解字段无法通过Cloud Config Server动态更新

问题现象 #

使用Spring Cloud Config实现应用配置外部化，首次启动应用可正常从配置中心获取@Value注解字段的值，但更新GitHub仓库中的配置值并触发/actuator/refresh接口后，字段值未在运行时更新，接口返回仅为["config.client.version"]。

客户端控制器代码 #

@RefreshScope
@RestController
@RequestMapping("/apiService")
public class DemoApiController {

    @Value("${scheduledTaskCronExpression}")
    private String scheduledTaskCronExpression;

    @GetMapping("getCurrentCronExpression")
    public String getScheduledTaskCronExpression() {
        return scheduledTaskCronExpression;
    }
}

配置中心application.properties #

spring.application.name=CentralConfig
server.port=8888
spring.profiles.active=local,development,production
spring.cloud.config.server.git.uri=https://github.com/XXX
spring.cloud.config.server.git.clone-on-start=true
spring.cloud.config.server.git.search-paths=MyApiService
spring.cloud.config.server.git.username=XXX
spring.cloud.config.server.git.password=XXX
spring.cloud.config.server.git.default-label=main
management.security.enabled=false
health.config.enabled=false

客户端MyApiService的application.properties #

spring.cloud.config.enabled=true
spring.application.name=MyApiService
spring.config.import=optional:configserver:http://localhost:8888/ 
spring.profiles.active=development
management.endpoints.web.exposure.include=*
management.endpoint.health.enabled=true
spring.cloud.config.name=MyApiService

操作与日志详情 #

1. GitHub仓库中MyApiService.properties初始值为scheduledTaskCronExpression=0 * * * * *，应用首次启动可正常获取该值。
2. 更新仓库值为scheduledTaskCronExpression=0 */2 * * * *，调用POST http://localhost:8082/actuator/refresh接口，响应为["config.client.version"]，但@Value字段未更新。
3. 刷新接口关键日志：

o.s.web.servlet.DispatcherServlet    - POST "/actuator/refresh", parameters={}
o.s.b.d.e.DevToolsPropertyDefaultsPostProcessor - Devtools property defaults active! Set 
'spring.devtools.add-properties' to 'false' to disable
o.s.c.c.c.ConfigServicePropertySourceLocator - Fetching config from server at : 
http://localhost:8888
o.s.web.client.RestTemplate          - HTTP GET http://localhost:8888/application/development
o.s.web.client.RestTemplate          - Accept=[application/json, application/*+json]
o.s.web.client.RestTemplate          - Response 200 OK
o.s.web.client.RestTemplate          - Reading to 
[org.springframework.cloud.config.environment.Environment]
o.s.c.c.c.ConfigServicePropertySourceLocator - Located environment: name=application, 
profiles=[development], label=null, version=f8b98f89c9212b1f0f5f53605a4b946aec47f40f, 
state=null
o.s.c.b.c.PropertySourceBootstrapConfiguration - Located property source: 
[BootstrapPropertySource {name='bootstrapProperties-configClient'}]
o.s.boot.SpringApplication           - The following 1 profile is active: "development"
o.s.boot.SpringApplication           - Started application in 1.894 seconds (process running 
for 1687.615)
o.s.w.s.m.m.a.RequestResponseBodyMethodProcessor - Using 'application/vnd.spring- 
boot.actuator.v3+json', given [*/*] and supported [application/vnd.spring- 
boot.actuator.v3+json, application/vnd.spring-boot.actuator.v2+json, application/json]
o.s.w.s.m.m.a.RequestResponseBodyMethodProcessor - Writing [[config.client.version]]
o.s.web.servlet.DispatcherServlet    - Completed 200 OK

问题原因与解决办法 #

核心原因 #

1. 配置拉取路径不匹配：日志显示客户端拉取的是http://localhost:8888/application/development，但实际应拉取http://localhost:8888/MyApiService/development，说明配置中心未正确匹配到对应应用的配置文件。
2. Spring Boot版本兼容问题：若使用Spring Boot 2.4+，默认禁用了bootstrap上下文，需额外引入依赖才能正常加载配置中心配置。
3. @RefreshScope代理失效：private字段的直接访问可能导致动态代理无法正确更新值，需调整获取配置的方式。

具体修复步骤 #

1. 修正配置拉取路径

将客户端的spring.config.import配置改为明确指定应用名称，确保拉取对应配置：

spring.config.import=configserver:http://localhost:8888/MyApiService

2. 引入必要依赖（Maven为例）

针对Spring Boot 2.4+版本，需引入spring-cloud-starter-bootstrap以启用bootstrap上下文，同时确保核心依赖齐全：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-config</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

3. 优化配置获取方式

改用Environment对象获取配置，避免@Value的代理失效问题：

@RefreshScope
@RestController
@RequestMapping("/apiService")
public class DemoApiController {

    @Autowired
    private Environment env;

    @GetMapping("getCurrentCronExpression")
    public String getScheduledTaskCronExpression() {
        return env.getProperty("scheduledTaskCronExpression");
    }
}

4. 验证配置中心拉取正确性

手动访问http://localhost:8888/MyApiService/development，确认返回的配置中包含更新后的scheduledTaskCronExpression值。若未包含，检查配置中心的git配置：

• 确认spring.cloud.config.server.git.search-paths指向包含MyApiService.properties的目录
• 若配置中心未自动拉取GitHub更新，可重启配置中心或设置spring.cloud.config.server.git.refresh-rate配置刷新间隔

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