Node.js+Express对接MongoDB失败，API请求返回500错误求助

核心问题分析 #

你遇到的两个现象是关联的：

1. 500错误返回HTML而非JSON：Express默认的内置错误处理中间件会返回HTML格式的错误页面，而非JSON
2. TypeError [ERR_INVALID_ARG_TYPE]：代码中存在调用响应方法（如res.send()/res.json()）时传入undefined的情况

分步解决 #

1. 替换默认错误处理，强制返回JSON错误 #

在你的Express应用末尾添加自定义全局错误处理中间件，确保所有错误都返回JSON格式：

// 必须放在所有路由之后
app.use((err, req, res, next) => {
  console.error(err.stack);
  // 生产环境隐藏详细错误栈，开发环境可暴露
  const errorDetails = process.env.NODE_ENV === 'production' 
    ? {} 
    : { stack: err.stack };
  
  res.status(err.statusCode || 500).json({
    success: false,
    message: err.message || '服务器内部错误',
    error: errorDetails
  });
});

2. 排查并修复undefined传入响应方法的问题 #

终端报错明确指出data参数为undefined，需要检查以下场景：

• 路由中直接发送未定义变量：比如数据库查询返回null后未做判断，直接传给res.json()，或者误写res.send()（无参数）
• 错误捕获逻辑漏洞：try/catch中错误处理不当，比如直接res.send(err)但err的某个属性未定义，或者未正确传递错误到全局中间件

示例修复（注册接口）

app.post('/api/auth/register', async (req, res, next) => {
  try {
    // 1. 先校验请求参数，避免空值进入数据库操作
    const { username, password } = req.body;
    if (!username || !password) {
      return res.status(400).json({
        success: false,
        message: '用户名和密码不能为空'
      });
    }

    // 2. 检查用户是否已存在
    const existingUser = await User.findOne({ username });
    if (existingUser) {
      return res.status(409).json({
        success: false,
        message: '用户名已被注册'
      });
    }

    // 3. 创建用户并返回明确的响应数据
    const newUser = await User.create({ username, password });
    res.status(201).json({
      success: true,
      message: '注册成功',
      data: {
        userId: newUser._id,
        username: newUser.username
      }
    });
  } catch (err) {
    // 将错误传递给全局错误处理中间件，避免自行处理时出现参数错误
    next(err);
  }
});

3. 检查数据库连接与模型定义 #

• 确认MongoDB连接代码正常执行，无连接失败情况：

const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/your-db-name')
  .then(() => console.log('MongoDB连接成功'))
  .catch(err => console.error('MongoDB连接失败:', err));

• 检查用户模型（User）的字段定义，确保必填字段有校验规则，避免创建用户时因字段缺失抛出未捕获错误

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