Spring Cloud API Gateway转发POST至单体应用异常排查

一、确认网关实际发送的请求详情 #

• 开启全量请求日志打印：在Spring Cloud Gateway配置文件中，将网关核心组件的日志级别设为DEBUG，可完整查看请求转发时的方法、URI、头信息等细节：

  logging:
    level:
      org.springframework.cloud.gateway: DEBUG
      org.springframework.http.server.reactive: DEBUG
  

• 本地代理抓包验证：在网关与单体应用之间搭建Charles、Fiddler等代理工具，直接捕获网关转发的原始请求，直观确认请求方法、参数、路径是否符合预期。
• 自定义全局过滤器记录请求：编写简单的全局过滤器，在请求转发前后记录关键信息，代码示例：

  @Component
  public class RequestTraceFilter implements GlobalFilter, Ordered {
      private static final Logger LOGGER = LoggerFactory.getLogger(RequestTraceFilter.class);
  
      @Override
      public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
          ServerHttpRequest request = exchange.getRequest();
          // 记录转发前的请求方法、URI、头信息
          LOGGER.debug("Forwarding request -> Method: {}, URI: {}, Headers: {}",
                  request.getMethod(), request.getURI(), request.getHeaders());
  
          return chain.filter(exchange).then(Mono.fromRunnable(() -> {
              ServerHttpResponse response = exchange.getResponse();
              // 可选：记录响应状态码
              LOGGER.debug("Response received -> Status: {}", response.getStatusCode());
          }));
      }
  
      @Override
      public int getOrder() {
          return Ordered.HIGHEST_PRECEDENCE;
      }
  }
  

二、关于网关是否会先发送GET再发送POST #

Spring Cloud Gateway默认不会主动将POST转为GET，也不存在先发送GET再发送POST的逻辑。出现POST变GET的情况，通常是以下原因导致：

• 单体应用重定向触发方法转换：若单体应用对POST请求返回3xx重定向（如301/302），网关默认会跟随重定向，而根据HTTP规范，客户端/浏览器会自动将POST转为GET请求访问重定向地址。可检查单体应用的响应头是否包含Location字段。
• 路由配置错误：路由规则中若误配置rewritePath、redirectTo等逻辑，可能意外修改请求方法或路径。需仔细核对路由配置，确保无强制修改请求方法的代码。
• Servlet路径匹配问题：Java Servlet的路径匹配规则与Spring Boot存在差异，若网关转发的路径在单体应用中仅配置了GET映射，未配置POST映射，会返回405错误，可能被日志误判为请求方法被转换。

三、额外排查方向 #

• 关闭网关重定向跟随：在配置中关闭follow-redirects，避免因重定向导致的方法转换：

  spring:
    cloud:
      gateway:
        httpclient:
          follow-redirects: false
  

• 直接验证单体应用：绕过网关，用POST请求直接访问单体应用的目标接口，确认接口本身能正常响应POST请求，排除应用自身问题。

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