You need to enable JavaScript to run this app. Postman测试登录接口POST请求收不到参数,前端与Jest调用正常
优惠活动
大模型
产品
解决方案
定价
更多

Postman测试登录接口POST请求收不到参数,前端与Jest调用正常

Postman调用登录接口出现req.body为空的排查指南

核心现象

  • 前端浏览器调用/login接口完全正常;Jest编写的接口测试用例可全量通过,两类场景下后端都能正确解析参数
  • Postman端发送同接口请求时,哪怕已经在Body区域填好了提交参数,后端日志打印的请求体还是空对象{}
  • 请求能正常到服务端,但直接返回500,报错为TypeError: Cannot read property 'username' of undefined

已验证的正常请求标准

  • 前端调用逻辑:axios.post('login', { data: user }),其中user是{username: 'admin', password: 'admin'}结构,最终发出去的请求体结构为{data: { username: 'admin', password: 'admin' }}
  • 后端取参逻辑:直接从req.body.data.username、req.body.data.password读取参数
  • Jest测试用例直接构造上述结构的JSON请求体发送,可正常返回200状态码

最常见的异常原因

  • Postman请求格式和后端解析规则不匹配。Express框架的express.json()中间件只会解析携带application/json请求头的请求体,如果Postman选了x-www-form-urlencoded、form-data表单格式,或者选了raw模式但未指定JSON类型,中间件根本不会解析请求体,最后路由拿到的req.body自然是空对象
  • 请求路径不对齐。如果Postman填写的路径漏了项目前缀(比如后端实际路由为/api/v1/login,Postman仅填写/login),会命中其他未挂载JSON解析中间件的路由,也会出现请求体为空的问题
  • Postman全局配置干扰。如果集合或全局配置中存在前置脚本、路径重定向规则,实际发请求时可能直接把请求体清空;尤其是HTTP跳转HTTPS的重定向,Postman默认不会携带原始POST请求的Body完成跳转

排查步骤

  • 检查Postman的请求头配置,确认存在Content-Type: application/json,避免手动添加错误的Content-Type值覆盖默认配置
  • 确认Body区域选择raw格式下的JSON子选项,填入的参数严格匹配正确结构:
    {
      "data": {
        "username": "admin",
        "password": "admin"
      }
    }
    
  • 对照Jest用例的请求路径,把Postman的请求URL一字不差抄过去,不要漏写前缀、出现路径拼写错误
  • 临时关闭所有Postman前置脚本、全局请求规则,发送最小化测试请求,排除配置干扰
  • 查看后端日志记录的实际命中路由,确认请求未错配到其他未做请求体解析的路由上

内容的提问来源于stack exchange,提问作者Mr.P

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 14:54:01