Spring Cloud Config Server配置git refreshRate后客户端未获变更通知求助

首先得明确一个关键误区：spring.cloud.config.server.git.refreshRate 这个配置只是让Config Server定期从Git仓库拉取最新配置到自身缓存，它并不会主动把更新推送给客户端。这就是你遇到问题的核心——你以为这个属性能自动触发客户端刷新，但它其实只负责Server端的本地配置同步。

要实现Git变更后客户端自动刷新配置，你需要结合Spring Cloud Bus和Actuator来完成，下面是具体的操作步骤：

1. 给客户端添加必要依赖 #

你的Config Server已经开启了Spring Cloud Bus（spring.cloud.bus.enabled=true），所以客户端需要补充以下依赖（以Maven为例）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>

如果用Gradle，对应调整依赖声明即可。

2. 调整客户端配置文件 #

在客户端的配置文件（比如application.yml）中，需要完成以下配置：

• 暴露Actuator的refresh和bus-refresh端点
• 配置指向Config Server的地址，开启配置刷新支持

server:
  port: 8081 # 和Config Server端口区分开
spring:
  application:
    name: your-client-app-name # 对应Git仓库中配置的应用名称
  cloud:
    config:
      uri: http://localhost:8080 # 你的Config Server地址
      enabled: true
management:
  endpoints:
    web:
      exposure:
        include: refresh,bus-refresh
  endpoint:
    refresh:
      enabled: true

另外，客户端中需要读取配置的Bean，必须加上@RefreshScope注解才能实现配置刷新，比如：

@RestController
@RefreshScope
public class ConfigController {
    @Value("${your.config.key}")
    private String configValue;

    @GetMapping("/config")
    public String getConfig() {
        return configValue;
    }
}

3. 触发配置刷新的两种方式 #

方式一：手动触发 #

当Git仓库的配置变更后，你可以手动向Config Server发送POST请求到/actuator/bus-refresh端点，这个请求会通过Spring Cloud Bus把刷新信号广播给所有连接的客户端，客户端收到信号后就会从Config Server拉取最新配置。

方式二：Git钩子自动触发 #

这是更自动化的方案，你可以在Git仓库中配置Webhook（比如GitHub的Webhook、GitLab的集成功能），当仓库有push操作时，自动向你的Config Server发送POST请求到/actuator/bus-refresh端点，实现完全自动的配置刷新。

4. 再明确refreshRate的作用 #

你配置的refreshRate:15单位是秒，意思是Config Server每15秒会去Git仓库检查一次配置是否有更新，如果有就拉取到本地缓存。但即使Server端缓存更新了，客户端也不会主动感知，必须通过上面的Bus刷新机制来触发客户端拉取新配置。

总结一下：refreshRate保证Server端缓存是最新的，而Spring Cloud Bus负责把更新通知给客户端，两者配合才能实现你想要的「Git变更后属性自动刷新」功能。

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