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
相关产品推荐
相关产品推荐

