如何在不使用Spring Actuator /refresh端点的情况下触发配置刷新事件？

一、不使用Spring Actuator /refresh端点触发配置刷新的方法 #

如果你的类标注了@ConfigurationProperties和@RefreshScope，不想通过Actuator的/refresh端点触发刷新，可以用以下几种灵活的方式：

1. 手动调用RefreshScope的刷新方法 #

直接注入RefreshScope bean，按需刷新指定bean或所有带@RefreshScope的bean：

import org.springframework.cloud.context.scope.refresh.RefreshScope;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class ConfigRefreshService {

    @Autowired
    private RefreshScope refreshScope;

    // 刷新指定名称的配置bean
    public void refreshSpecificConfig(String beanName) {
        refreshScope.refresh(beanName);
    }

    // 刷新所有带@RefreshScope的bean
    public void refreshAllConfigs() {
        refreshScope.refreshAll();
    }
}

如果不清楚目标bean的名称，可以通过ApplicationContext查询，或者在配置类上用@Qualifier明确指定bean名称。

2. 通过自定义事件触发刷新 #

自定义一个事件，在监听器中封装刷新逻辑，这样就能在业务代码的任意位置发布事件来触发刷新：
首先定义自定义事件：

import org.springframework.context.ApplicationEvent;

public class CustomConfigRefreshEvent extends ApplicationEvent {
    public CustomConfigRefreshEvent(Object source) {
        super(source);
    }
}

然后编写事件监听器：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cloud.context.scope.refresh.RefreshScope;
import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;

@Component
public class CustomConfigRefreshListener implements ApplicationListener<CustomConfigRefreshEvent> {

    @Autowired
    private RefreshScope refreshScope;

    @Override
    public void onApplicationEvent(CustomConfigRefreshEvent event) {
        // 可选择刷新全部或指定bean
        refreshScope.refreshAll();
    }
}

最后在需要触发刷新的业务逻辑中发布事件：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.ApplicationEventPublisher;
import org.springframework.stereotype.Service;

@Service
public class SomeBusinessService {

    @Autowired
    private ApplicationEventPublisher eventPublisher;

    public void doBusinessAndRefreshConfig() {
        // 执行业务逻辑
        // 触发配置刷新
        eventPublisher.publishEvent(new CustomConfigRefreshEvent(this));
    }
}

3. 直接调用RefreshEndpoint的内部方法 #

Actuator的/refresh端点底层就是调用RefreshEndpoint的refresh()方法，如果你不想启用Actuator，可以直接注入这个类并调用方法：

import org.springframework.cloud.endpoint.RefreshEndpoint;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import java.util.List;

@Component
public class ConfigRefreshHelper {

    @Autowired
    private RefreshEndpoint refreshEndpoint;

    public List<String> triggerRefresh() {
        // 返回被刷新的bean名称列表
        return refreshEndpoint.refresh();
    }
}

注意：RefreshEndpoint属于spring-cloud-context包，确保项目已引入Spring Cloud相关依赖。

二、应用从Config Server获取配置的必备条件 #

要让客户端应用成功从Config Server拉取配置，需要满足以下核心条件：

• 依赖配置正确：必须引入Spring Cloud Config Client依赖，Maven示例：

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

Gradle示例：

implementation 'org.springframework.cloud:spring-cloud-starter-config'

• bootstrap配置文件设置：需在bootstrap.yml（或bootstrap.properties）中配置Config Server核心信息：

spring:
  application:
    name: your-application-name  # 对应Config Server上的配置文件前缀
  cloud:
    config:
      uri: http://your-config-server-host:port  # Config Server的访问地址
      profile: dev  # 要拉取的环境配置（如dev、prod）
      # 若Config Server开启认证，添加以下配置
      username: your-username
      password: your-password

注意：bootstrap配置文件优先级高于application配置文件，会在应用启动初期加载，用来建立与Config Server的连接。

• 配置类注解规范：

  • 标注@ConfigurationProperties的类需指定正确的prefix，与Config Server上的配置前缀对应；
  • 若需要动态刷新，必须配合@RefreshScope注解；
  • 主启动类或配置类上需添加@EnableConfigurationProperties启用配置属性绑定（或在配置类上添加@Component让Spring扫描到）。

• Config Server端配置正确：

  • Config Server需正常运行，配置仓库（如Git、本地文件）中存在对应配置文件，文件名格式为{application-name}-{profile}.yml（或.properties），比如your-application-name-dev.yml；
  • 配置仓库权限正常，能被Config Server读取。

• 网络与版本兼容：

  • 客户端应用可正常访问Config Server地址，无网络防火墙或策略阻挡；
  • Spring Boot与Spring Cloud版本需兼容，比如Spring Boot 2.7.x对应Spring Cloud 2021.0.x（Jubilee版本），避免版本不兼容导致的连接或配置加载失败。

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