使用Netflix Eureka与Zuul时POST方法不支持问题求助

兄弟，我之前碰到过几乎一模一样的问题！本地跑POST完全正常，打包上服务器、注册Eureka也没问题，就是过Zuul网关调用POST就报405。结合我的排查经验，大概率是这几个环节出了问题，咱们一个个来捋：

很多时候405是因为Zuul把请求转发到了错误的路径，而那个路径根本不支持POST方法。

• 打开你的Zuul网关配置文件（比如application.yml），核对路由规则：
  假设你的服务POST接口是/api/v1/users，Zuul配置的路由是：

  zuul:
    routes:
      user-service:
        path: /user/**
        service-id: user-service
        strip-prefix: true
  

  这里要确保strip-prefix设置正确：如果strip-prefix: true，那么/user/api/v1/users会被转发成/api/v1/users到user-service；如果设成false，就会变成/user/api/v1/users，要是你的服务没这个路径，就会触发405。
• 另外，检查有没有不小心给路由加了请求方法限制，比如某些配置里误加了methods: GET，那POST请求自然会被拦截。

如果你的服务用了Spring Security，生产环境大概率会开启CSRF防护，而Zuul转发的POST请求默认不会携带CSRF Token，直接就被拦了。

• 解决方案是在服务的Security配置类里，针对Zuul过来的内部请求关闭CSRF防护：

  @Configuration
  public class SecurityConfig extends WebSecurityConfigurerAdapter {
      @Override
      protected void configure(HttpSecurity http) throws Exception {
          // 忽略你的API路径，允许Zuul转发的POST请求通过
          http.csrf().ignoringAntMatchers("/api/**")
              .and()
              .authorizeRequests()
              .antMatchers("/api/**").permitAll();
      }
  }
  

• 要是你的Zuul网关本身已经做了CSRF防护，服务端完全可以放宽内部请求的限制，毕竟网关已经把第一道关了。

Zuul默认会过滤掉Cookie、Set-Cookie这两个敏感头，但如果你的POST请求依赖其他自定义头，或者服务端对Content-Type有严格要求，头丢失也可能导致请求被识别错误。

• 调整Zuul的敏感头配置，确保需要的请求头能正常转发：

  zuul:
    # 只保留默认的Cookie、Set-Cookie作为敏感头，其他头全部允许转发
    sensitive-headers: Cookie,Set-Cookie
    # 如果有自定义头需要排除过滤，也可以在这里调整
  

• 另外，检查客户端发送的POST请求Content-Type是否和服务端接口匹配：比如服务端用@RequestBody接收JSON，客户端就得发application/json，要是发成application/x-www-form-urlencoded，服务端可能找不到对应的POST处理器，也会报405。

有时候服务注册到Eureka的IP、端口不对，Zuul拿到错误的实例地址，转发请求自然出问题。

• 打开Eureka控制台，查看你的服务实例详情，确认homePageUrl、statusPageUrl是服务器的正确内网/外网地址，端口也和服务启动的一致。
• 可以在服务的配置里加上eureka.instance.prefer-ip-address: true，强制服务用IP注册，避免因为主机名解析问题导致Zuul找不到正确的实例。

要是上面的排查都没找到问题，直接开DEBUG日志看请求流转的全过程：

• 在Zuul网关和你的服务的配置文件里都加上日志级别配置：

  logging:
    level:
      com.netflix.zuul: DEBUG
      org.springframework.web: DEBUG
  

• 重启服务后，看Zuul的日志里有没有请求转发的详细记录，比如转发的URL、请求方法、头信息；再看服务端的日志，确认收到的请求到底是什么样的——是方法被改成GET了？还是路径错了？一看日志就一目了然。

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