NodeJS TypeError: Cannot read property 'name' of undefined问题求助

Hey there! As someone who's been where you are, let's figure out why this error is popping up—chances are it's not about Mongoose or Node.js versions, but something simpler with how your server handles incoming requests.

最可能的原因 #

1. 没配置请求体解析中间件 #

Express 不会自动解析 JSON 或表单格式的请求体。如果跳过这一步，req.body 会是 undefined，此时尝试访问 req.body.name 就会抛出你遇到的这个错误。

2. 请求方式或 Postman 配置错误 #

• 如果你在 Postman 里用了 GET 请求：GET 请求通常不携带请求体，所以 Express 不会解析任何内容到 req.body 里，换成 POST、PUT 或 PATCH 试试。
• 用对了请求方法但还是有问题：检查 Postman 的 Body 标签是否选了 raw > JSON，同时确认你的 JSON 格式是正确的（键和值都用引号包裹，没有遗漏逗号）。

3. 代码里的变量拼写错误 #

很容易搞混 req 和 res，或者把 body 拼错（比如写成 req.bod）。一个小小的拼写失误，就会导致你试图在一个未定义的值上访问 name 属性。

分步解决方案 #

第一步：添加请求体解析中间件 #

在定义任何路由之前，给你的 Express 应用加上这两行代码：

const express = require('express');
const app = express();

// 解析JSON格式的请求体
app.use(express.json());
// 解析表单编码的请求体（如果需要处理form-data格式）
app.use(express.urlencoded({ extended: true }));

// 之后再定义路由、连接数据库等操作

第二步：验证 Postman 请求设置 #

1. 将请求方法设置为 POST（或你的接口预期的方法）。
2. 切换到 Body 标签，选择 raw，并从下拉菜单中选 JSON。
3. 粘贴一个格式正确的 JSON 示例：

{
  "name": "Toyota Camry"
}

4. 再次发送请求，确保访问的是正确的接口 URL。

第三步：检查你的控制器/路由代码 #

仔细确认你是用 req.body（不是 res.body 或拼写错误的版本）来获取请求数据。下面是创建汽车文档的正确示例：

app.post('/cars', async (req, res) => {
  try {
    // 先确认请求体存在
    if (!req.body) {
      return res.status(400).json({ error: "请求体不能为空" });
    }
    const newCar = await Car.create(req.body);
    res.status(201).json(newCar);
  } catch (err) {
    res.status(400).json({ error: err.message });
  }
});

额外提示 #

虽然你更新了 Mongoose 和 Node.js，但这个错误和它们的版本无关。核心问题是确保你的服务器能正确读取请求体。

如果还是有问题，可以在路由处理函数开头打印 req.body，确认它是否被正确解析：

console.log('请求体内容:', req.body);

如果打印结果是 undefined，回到第一步检查——你的中间件可能没加，或者加在了路由定义之后。

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