调用Express REST API返回500错误，求调试与排查方法

你的问题核心是无法获取500错误的详细原因，以下是直接落地的调试方案：

1. 修复错误中间件，输出完整错误信息 #

你当前用JSON.stringify(err)会丢失Error对象的堆栈等关键信息（这类属性不可枚举，JSON序列化不会包含），修改错误处理中间件：

// error handler
app.use(function(err, req, res, next) {
  res.locals.message = err.message;
  res.locals.error = req.app.get('env') === 'development' ? err : {};
  // 直接打印错误对象，保留堆栈轨迹
  console.error('服务器错误详情:', err);
  // 开发环境返回详细错误，生产环境隐藏敏感信息
  const response = req.app.get('env') === 'development' 
    ? { message: err.message, stack: err.stack }
    : { message: "处理请求时出错" };
  res.status(err.status || 500).json(response);
});

2. 开启Express内置调试模式 #

启动服务器时设置环境变量，查看Express内部请求处理的完整流程（路由匹配、中间件调用等）：

# Windows
set DEBUG=express:* && node app.js

# Linux/macOS
DEBUG=express:* node app.js

3. 在控制器中添加关键日志并捕获异步错误 #

如果addUserHandler是异步函数，必须用try-catch捕获错误并传递给错误中间件，同时在关键步骤加日志：

async function addUserHandler(req, res, next) {
  try {
    console.log('接收到的注册参数:', req.body);
    // 业务逻辑（比如数据库操作）
    const createResult = await userModel.create(req.body);
    console.log('用户创建结果:', createResult);
    res.status(201).json({ message: '注册成功' });
  } catch (err) {
    console.error('注册流程出错:', err);
    // 将错误交给全局错误中间件处理
    next(err);
  }
}

4. 检查路由冲突与请求解析中间件 #

• 你同时配置了app.use('/users/register-user', usersRouter)和app.post('/users/register-user', addUserHandler)，可能导致路由匹配冲突，确认usersRouter内是否有重复的POST路由，移除其中一个重复配置。
• 确保在所有路由前添加express.json()中间件，否则req.body会是undefined，这是JSON POST请求的常见错误：

// 放在所有路由配置之前
app.use(express.json());

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