MongoDB+Node.js登录功能报错：checkUser无法读取undefined的username属性

你遇到的TypeError: Cannot read property 'username' of undefined错误，本质是代码里尝试访问一个undefined值的username（或你代码里的userName）属性，结合登录场景，大概率是这几个环节出了问题，我给你逐一梳理解决办法：

1. 检查checkUser的参数是否正确传入 #

最常见的原因是你在POST登录接口里调用checkUser时，没把前端传来的用户数据正确传递进去，导致userData本身就是undefined，后续访问它的属性自然会报错。

比如错误的接口代码示例：

app.post('/login', (req, res) => {
  // 未传递任何参数，userData为undefined
  checkUser()
    .then(...)
    .catch(...);
});

解决办法：
首先确保你已经用express.json()中间件解析请求体（这一步很容易遗漏！），然后把前端传来的req.body正确传给checkUser：

// 在服务器入口文件（如app.js）添加解析中间件
app.use(express.json());

// 修正后的登录接口
app.post('/login', (req, res) => {
  const userData = req.body; // 获取前端发送的用户名密码对象
  checkUser(userData)
    .then(foundUser => {
      if (foundUser) {
        res.status(200).json({ message: '登录成功！' });
      } else {
        res.status(401).json({ message: '用户名或密码错误' });
      }
    })
    .catch(err => res.status(500).json({ error: err.message }));
});

2. 修正checkUser函数里的拼写和查询逻辑 #

看你给出的代码片段User.find({ userName: userDa...，这里明显是userData的拼写截断，如果你实际代码里写错了变量名（比如写成userDa），或者字段名和前端/数据库不匹配，也会触发这个错误。

另外，登录场景用findOne比find更合适——find会返回所有匹配的用户数组，而我们只需要找单个匹配的用户：

修正后的checkUser函数示例：

function checkUser(userData) {
  // 先做参数校验，避免后续报错
  if (!userData || !userData.userName || !userData.password) {
    return Promise.reject(new Error('用户数据不完整，请传入用户名和密码'));
  }
  // 用findOne查询单个匹配用户，确保字段名和MongoDB集合里的一致
  return User.findOne({ 
    userName: userData.userName, 
    password: userData.password 
  });
}

注意：如果你的MongoDB集合里存的字段是username（小写），但代码里写的是userName（驼峰），也会导致查询异常，一定要和数据库字段保持一致。

3. 确认前端请求格式是否正确 #

如果前端没有以JSON格式发送POST请求，或者没设置Content-Type: application/json请求头，那么req.body会是undefined，传给checkUser的userData自然也是undefined。

前端正确请求示例（fetch）：

fetch('/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json' // 必须设置这个请求头
  },
  body: JSON.stringify({ userName: '你的用户名', password: '你的密码' })
})
.then(res => res.json())
.then(data => console.log(data));

快速排查小技巧 #

你可以在checkUser函数开头加个日志，直接看控制台输出的userData是什么，快速定位问题：

function checkUser(userData) {
  console.log('传入的用户数据：', userData); // 查看控制台是否输出预期的对象
  // 后续逻辑...
}

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