Spring Cloud Gateway GET接口正常但POST请求无法到达控制器问题求助

1. 跨域配置校验 #

绝大多数情况下该问题由跨域配置限制导致，检查Gateway的全局跨域配置是否允许POST方法：

• 配置文件方式需确认allowed-methods包含POST或配置为*，示例正确配置：

spring:
  cloud:
    gateway:
      globalcors:
        cors-configurations:
          '[/**]':
            allowed-origins: "*"
            allowed-methods: "*"
            allowed-headers: "*"
            allow-credentials: true

• 代码注册CorsWebFilter的场景，需显式添加POST到允许方法列表。

2. 路由规则校验 #

• 检查路由断言中是否误加了Method=GET限制，导致POST请求无法匹配到对应路由，如需同时支持GET、POST可修改为Method=GET,POST，无方法限制可直接移除该断言。
• 排查所有自定义全局过滤器、路由过滤器是否对POST请求做了拦截校验（如请求Body校验、权限校验），存在校验失败后无日志输出直接返回的逻辑。

3. 下游微服务配置校验 #

• 确认目标Controller接口注解正确，未误将@PostMapping写为@GetMapping，路径与Gateway转发后的路径完全匹配。
• 若下游微服务集成了Spring Security，默认开启的CSRF防护会拦截POST请求，需显式关闭CSRF，示例配置：

@Configuration
public class SecurityConfiguration {
    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        return http.csrf(CsrfConfigurer::disable)
                // 其余业务配置
                .build();
    }
}

• 检查参数解析逻辑是否异常，可临时将@RequestBody的required属性设为false，验证请求是否能进入Controller方法，排除请求体格式不匹配导致的框架层拦截。

4. 日志辅助排查 #

开启Gateway的调试日志，定位POST请求的路由匹配、转发流程：

logging:
  level:
    org.springframework.cloud.gateway: DEBUG

可在下游微服务添加全局请求拦截器，打印所有进入的请求信息，确认请求是否已经从Gateway转发到微服务实例，进一步缩小问题范围。

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