Spring Cloud Finchley.M8中Refresh接口请求异常：GET返回404、POST报错

嘿，针对你遇到的问题，我结合Finchley.M8和Spring Boot 2.0.0.RELEASE的特性，梳理几个核心排查和解决的关键点：

1. 先明确：GET请求/refresh返回404是正常行为 #

首先要搞清楚，Spring Cloud的/refresh端点只支持POST请求——它的作用是触发客户端主动刷新配置，GET请求本来就没有对应的处理逻辑，所以返回404是预期结果，不用在这个点上浪费精力，重点解决POST请求的报错问题。

2. 检查Actuator依赖是否正确引入 #

Finchley版本的Spring Cloud客户端，要启用/refresh端点必须依赖spring-boot-starter-actuator，先确认你的pom.xml（或build.gradle）里有没有这个依赖：

<!-- Maven示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

如果缺失这个依赖，actuator端点根本不会被注册，自然会出现请求异常。

3. 配置Actuator端点的暴露与启用 #

Spring Boot 2.x和1.x的Actuator配置差异很大，Finchley版本默认只暴露health和info两个端点，你需要手动配置暴露refresh：
在application.yml（或application.properties）中添加：

management:
  endpoints:
    web:
      exposure:
        include: refresh  # 也可以用"*"暴露所有端点，按需选择
  endpoint:
    refresh:
      enabled: true  # 显式启用refresh端点（默认其实是true，但保险起见加上）

如果没有这段配置，/refresh端点不会被对外暴露，POST请求也会报错。

4. 处理CSRF与Spring Security的拦截问题 #

如果你的客户端引入了spring-boot-starter-security，默认会开启CSRF保护，而POST请求会被CSRF校验拦截，导致报错。解决方式有两种：

• 方式一：禁用/actuator/refresh的CSRF校验（最常用）
  创建一个Security配置类：

  import org.springframework.security.config.annotation.web.builders.HttpSecurity;
  import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
  import org.springframework.stereotype.Component;
  
  @Component
  public class ActuatorSecurityConfig extends WebSecurityConfigurerAdapter {
      @Override
      protected void configure(HttpSecurity http) throws Exception {
          http.csrf()
              .ignoringAntMatchers("/actuator/refresh")  // 跳过refresh端点的CSRF校验
              .and()
              .authorizeRequests()
              .antMatchers("/actuator/refresh").permitAll();  // 允许匿名访问，也可根据需求配置认证
      }
  }
  

• 方式二：发起POST请求时携带CSRF Token（适合需要保留全局CSRF保护的场景），但对于配置刷新端点，一般直接禁用该端点的CSRF更方便。

5. 确认Config Server的认证配置是否正确 #

客户端需要在bootstrap.yml中正确配置Config Server的基础认证信息，确保能正常拉取配置，否则刷新逻辑也可能异常：

spring:
  cloud:
    config:
      uri: http://localhost:你的ConfigServer端口
      username: 你的ConfigServer用户名
      password: 你的ConfigServer密码

按照以上步骤逐一排查，应该能解决POST请求/refresh的报错问题。

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