Post请求传递JSON：Spring与JavaScript交互异常问题

Postman能正常请求但前端（含Postman生成的JS代码）失败，问题基本出在请求头、数据序列化、跨域或前端环境配置上，按以下步骤逐一排查：

1. 强制指定Content-Type请求头 #

Postman会自动添加application/json头，但Axios在部分场景下（比如数据含特殊类型、自动序列化异常）不会正确设置，手动指定：

axios.post('/your-api-url', yourRequestData, {
  headers: {
    'Content-Type': 'application/json'
  }
})

如果yourRequestData是自定义类实例或非标准对象，手动转成JSON字符串再发送：

axios.post('/your-api-url', JSON.stringify(yourRequestData), {
  headers: { 'Content-Type': 'application/json' }
})

同时确认后端实体类字段与JSON键完全匹配（Spring默认驼峰映射，若用@JsonProperty需严格对应）。

2. 排查跨域（CORS）问题 #

浏览器会触发跨域限制但Postman不会，打开前端控制台的Network面板，看是否有CORS相关报错：

• 后端Spring可在控制器上加@CrossOrigin注解，或配置全局CORS过滤器；
• 确认前端请求的域名、端口在后端允许的跨域列表内。

3. 检查请求数据的序列化合法性 #

前端对象若含循环引用、undefined值，Axios序列化时会出错，导致后端解析失败。先打印验证：

console.log(JSON.stringify(yourRequestData));

若打印报错，清理掉undefined、循环引用的字段后再测试。

4. 查看后端异常日志 #

别只看前端报错，去Spring日志里找具体错误：

• HttpMessageNotReadableException：JSON解析失败，大概率是数据类型不匹配（比如前端传字符串后端要数字）；
• 字段校验报错：后端实体类有@NotNull等注解的必填字段，前端未传或传值为空。

5. 对比Postman与前端的请求详情 #

在浏览器Network面板里，把前端的请求头、请求体和Postman的完全对比：

• 排查是否有多余请求头（比如自定义头被后端拦截）；
• 确认请求体格式完全一致（比如JSON是否用双引号，有没有出现单引号的情况）。

6. 测试最简请求 #

先写一个只传核心字段的最简请求：

axios.post('/your-api-url', { id: 1, name: 'test' }, {
  headers: { 'Content-Type': 'application/json' }
})

如果这个能成功，再逐步添加原请求的字段，定位到导致失败的具体字段。

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