Spring MVC RestController POST请求报500错误排查求助

这种情况我之前踩过好几次坑，结合你描述的现象——GET正常、表单POST正常，但用工具/APP发POST就报HttpRequestMethodNotSupportedException，大概率是这几个原因导致的，咱们一步步排查：

1. CSRF防护拦截（最常见的元凶） #

Spring MVC默认会开启CSRF防护机制，表单提交时会自动生成并携带_csrf参数，所以能正常通过；但Android/Postman直接发送POST请求时不会带上这个token，就会被拦截，表面上显示“请求方法不支持”，实际是被CSRF过滤器挡了。

解决方案： #

• 测试环境/纯REST接口场景：直接关闭CSRF防护（如果你的接口不需要面向浏览器访问，完全可以这么做）。在Spring Security配置类中添加：

  @Override
  protected void configure(HttpSecurity http) throws Exception {
      http.csrf().disable();
      // 其他安全配置...
  }
  

• 需要保留CSRF的场景：先通过GET请求获取CSRF token，然后在POST请求的Header中添加X-XSRF-TOKEN字段，值为获取到的token。

2. 请求内容类型不匹配 #

表单提交的默认Content-Type是application/x-www-form-urlencoded，但Android/Postman可能发送的是application/json格式的请求，而你的Controller方法没有适配这种类型。

解决方案： #

• 如果接收表单格式参数：确保方法用@RequestParam绑定参数，且请求的Content-Type为application/x-www-form-urlencoded

  @PostMapping("/user")
  public ResponseEntity<?> addUser(@RequestParam("name") String name, @RequestParam("age") int age) {
      // 处理逻辑
      return ResponseEntity.ok("添加成功");
  }
  

• 如果接收JSON格式参数：需要用@RequestBody绑定实体类，同时确保项目依赖了JSON解析包（Spring Boot默认自带Jackson，纯Spring MVC需要手动引入）

  @PostMapping("/user")
  public ResponseEntity<?> addUser(@RequestBody User user) {
      // 处理逻辑
      return ResponseEntity.ok("添加成功");
  }
  

注意：发送请求时一定要保证Content-Type和方法接收的类型一致。

3. Controller注解配置错误 #

检查你的POST方法注解是否正确：

• 是不是误写了@GetMapping？
• 是不是@RequestMapping里只指定了RequestMethod.GET？

错误示例：

@RequestMapping(value = "/api/data", method = RequestMethod.GET) // 仅允许GET请求
public ResponseEntity<?> handleData() { ... }

正确的POST方法配置：

@PostMapping("/api/data")
public ResponseEntity<?> handlePostData(...) { ... }

或者需要同时支持GET/POST的话：

@RequestMapping(value = "/api/data", method = {RequestMethod.GET, RequestMethod.POST})
public ResponseEntity<?> handleData(...) { ... }

4. 请求路径不匹配 #

有时候工具/APP里的请求路径和Controller配置的路径有细微差异，比如多了斜杠、大小写不一致（虽然Spring MVC默认不区分，但最好核对一遍），导致找不到对应的POST方法，进而抛出“请求方法不支持”的异常。

先从CSRF和内容类型这两点排查，基本能解决大部分问题，如果还有其他细节可以再补充~

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