PUT接口Postman返回400但React前端调用返回500异常排查

这个问题和接口方法定义为void返回值没有任何关联。
如果void返回值会导致异常处理逻辑失效，Postman、Swagger测试时必然也会返回500，不会出现工具调用正常、浏览器前端调用异常的差异。

出现这种差异的核心原因是：Postman、Swagger发出的请求，和React端在浏览器环境下发出的请求在请求链路、请求内容上不一致，导致异常没有走到你编写的BadRequestException处理分支，最终返回默认的500错误。最常见的触发场景如下：

• 跨域预检请求未被正确处理
  浏览器的同源策略会限制跨域请求，对于PUT请求这类非简单请求，浏览器会自动先发送一个OPTIONS方法的预检请求到目标路径，校验后端是否允许当前域名跨域访问。如果后端没有配置CORS规则、也没有放行OPTIONS请求，这个预检请求会在过滤器/拦截器层直接抛出异常，而@ControllerAdvice默认只能捕获Controller层抛出的异常，拿不到过滤器层面抛出的异常，就会返回500状态码。Postman、Swagger不受浏览器同源策略约束，不会自动发送预检请求，因此不会触发这个问题。
• 前端请求构造存在错误
  对照Postman中正常调用的请求配置，逐一检查React端的请求：
  • 确认请求方法是否为PUT，有没有误写为其他方法
  • 确认路径拼接规则正确：projectIdentifiers是List类型的路径变量，Spring MVC默认支持逗号分隔的传参格式，比如/projA,projB,projC/analysts/test@example.com，如果前端传参格式错误、或者对项目标识、邮箱做了不符合预期的URL编码，会导致路径匹配失败、参数转换异常，这类异常不属于你定义的BadRequestException，没有对应处理逻辑时就会返回500
  • 确认请求携带了后端要求的认证信息（比如Token、Cookie），如果集成了Spring Security这类安全框架，未认证的请求会在过滤器层被拦截抛出异常，同样走不到Controller层的全局异常处理器。

直接打开Chrome开发者工具的网络面板，找到返回500的那条请求：

1. 先看请求方法是不是OPTIONS，如果是，补全后端CORS跨域配置即可解决
2. 查看500响应的响应体内容，服务端默认会把具体异常信息放在响应体里，直接看抛出的异常类型就能精准定位问题，不需要盲目排查
3. 把Postman正常请求的请求路径、请求头、参数和前端失败的请求做逐字段对比，找到两边的差异点就是问题根源。

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