SpringBoot 2.0.1中Actuator /refresh端点缺失问题求助

你遇到的问题本质是Spring Boot 2.x对Actuator模块做了重大重构，和1.5.x版本的端点规则、配置逻辑差异非常大，原来的端点路径和暴露策略都变了，下面是一步步的解决方法：

1. 确认依赖配置 #

首先，Spring Boot 2.x中Actuator的基础依赖还是spring-boot-starter-actuator，但如果你是Config Client场景，需要额外引入spring-cloud-starter-cloud-context来支持refresh这类配置刷新端点。

Maven依赖示例：

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

Gradle依赖示例：

implementation 'org.springframework.boot:spring-boot-starter-actuator'
implementation 'org.springframework.cloud:spring-cloud-starter-cloud-context'

2. 调整端点暴露与路径配置 #

Spring Boot 2.x默认只暴露health和info两个端点，而且所有Actuator端点的默认前缀变成了/actuator（1.5.x中没有这个前缀）。你需要通过配置手动开放需要的端点：

使用application.yml配置： #

management:
  endpoints:
    web:
      exposure:
        # 开放你需要的端点，*表示开放所有
        include: refresh, dump, heapdump, autoconfig
  # 可选：让health端点显示详细信息
  endpoint:
    health:
      show-details: always

使用application.properties配置： #

# 开放指定端点
management.endpoints.web.exposure.include=refresh,dump,heapdump,autoconfig
# 可选：健康端点显示详情
management.endpoint.health.show-details=always

3. 更新端点访问路径 #

配置完成后，原来的端点路径需要加上/actuator前缀：

• 原来的POST /refresh → 现在是POST /actuator/refresh
• 原来的GET /dump → 现在是GET /actuator/dump
• 原来的GET /heapdump → 现在是GET /actuator/heapdump
• 原来的GET /autoconfig → 现在是GET /actuator/autoconfig

4. 处理Spring Security拦截（如果有） #

如果你的项目中引入了Spring Security，它会默认拦截所有Actuator端点，需要在安全配置中开放这些路径：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            // 允许所有请求访问Actuator端点
            .antMatchers("/actuator/**").permitAll()
            // 其他请求保持认证要求
            .anyRequest().authenticated();
    }
}

5. 额外注意（Config Client场景） #

确保你的Config Client已经正确配置了bootstrap配置文件（bootstrap.yml或bootstrap.properties），并且能正常连接到Config Server。Spring Boot 2.x中，bootstrap配置的加载需要依赖spring-cloud-starter-config，如果还没引入，记得加上这个依赖。

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