TypeError: Cannot read properties of undefined (reading 'password')报错排查求助

这个报错的核心原因是**req.body 未定义**，代码尝试读取 req.body.password 时触发了类型错误。以下是具体排查和解决步骤：

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

这是最常见的触发原因。如果使用 Express 框架，必须在路由挂载前配置解析 JSON 或表单数据的中间件，否则 req.body 会始终为 undefined。

在你的 Express 入口文件（如 app.js/server.js）中添加以下代码：

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

// 解析 JSON 格式请求体
app.use(express.json());
// 解析 URL 编码的表单数据
app.use(express.urlencoded({ extended: true }));

// 之后再挂载业务路由
const userRoutes = require('./routes/user');
app.use('/api/users', userRoutes);

2. 验证请求发送的正确性 #

• 确保前端使用 POST 请求发送注册数据（GET 请求无请求体，req.body 必然为空）。
• 若发送 JSON 数据，必须设置请求头 Content-Type: application/json，示例：

fetch('/api/users/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    firstname: 'John',
    lastname: 'Doe',
    email: 'john@example.com',
    password: 'yourpassword'
  })
});

• 若为表单提交，确保表单设置 method="POST"，普通表单无需额外设置 enctype（默认格式可被上述中间件解析）。

3. 给控制器添加容错判断（可选但推荐） #

为避免程序崩溃，可在代码中先校验请求体及必填字段：

const register = (req, res, next) => {
  // 校验请求体是否存在
  if (!req.body) {
    return res.status(400).json({ message: '请求体不能为空' });
  }
  // 校验密码字段是否存在
  if (!req.body.password) {
    return res.status(400).json({ message: '密码不能为空' });
  }

  bcrypt.hash(req.body.password, 10, function(err, hashedPass) {
    if (err) {
      return res.json({ error: err });
    }
    let user = new User({
      firstname: req.body.firstname,
      lastname: req.body.lastname,
      email: req.body.email,
      password: hashedPass
    });
    user.save()
      .then(user => {
        res.json({ message: "User Added Successfully" });
      })
      .catch(error => {
        res.json({ message: 'An error Occurred' });
      });
  });   
}

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