Node.js+Express+MongoDB开发中POST请求req.body读取属性返回undefined问题

控制台输出异常的本质原因 #

• 现有代码中console.log("body "+req.body)采用字符串拼接逻辑，JavaScript会自动将Object类型的req.body调用默认toString()方法，固定输出[object Object]，无法反映req.body的实际字段结构，是排查过程中的核心误导点。
• 正确的调试打印方式：
  • 直接输出对象本身：console.log(req.body)
  • 格式化输出对象结构：console.log(JSON.stringify(req.body, null, 2))
    通过上述方式才能直观确认req.body内是否包含目标字段。
• 可临时增加请求头打印逻辑，确认中间件匹配性：在app.use(express.json())前增加测试中间件

  app.use((req, res, next) => {
    console.log('请求内容类型：', req.headers['content-type']);
    next();
  })
  

  核对发送的请求Content-Type是否与中间件解析要求匹配。

req.body.name返回undefined的核心诱因 #

在已正确配置app.use(express.json())、且中间件加载顺序正确的前提下，读取字段返回undefined通常由以下可复现问题导致：

1. Postman请求头匹配失败 #

• express.json()中间件仅会解析请求头中Content-Type值为application/json的请求体。
• 若测试时未在Postman的Body面板选择raw → JSON格式，误选form-data、x-www-form-urlencoded等其他格式，即使输入内容为类JSON结构，express.json()也会跳过解析逻辑，最终req.body为空对象，读取任意属性均返回undefined。

2. 请求体JSON格式非法 #

• 测试用的请求体在"tech":"NodeJS"字段后存在尾随逗号，不符合严格JSON语法规范：

  {
    "name":"vaibhav",
    "tech":"NodeJS",
  }
  

  express.json()解析非法JSON时会直接终止解析流程，req.body不会包含任何字段值。
• 修正后的合法请求体：

  {
    "name": "vaibhav",
    "tech": "NodeJS"
  }
  

代码中附带的潜在问题 #

• 数据模型文件内的字段校验存在拼写错误：tech字段下写为reqired: true，正确属性名是required: true，拼写错误会导致必填校验逻辑完全失效。
• 入口文件的路由引入路径需与实际文件名严格匹配：当前引入路径为./routers/aliens（复数），若实际路由文件名为alien.js（单数），会触发模块加载失败，需统一命名避免路径不匹配。

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