Express自定义错误处理程序未捕获Mongoose ValidationError问题排查

核心根因 #

你定义的错误处理程序完全接不到Mongoose抛出的ValidationError，本质是Express的错误传递机制和异步Promise的错误抛出没有打通：

• Express的错误处理中间件，本来设计上就只能捕获两类错误：一是同步路由逻辑里直接抛出的错误，二是通过next(err)手动传递的错误。
• Mongoose的文档保存、模型查询全是返回Promise的异步操作，如果你的路由处理函数没给这些异步Promise加捕获逻辑，触发的验证错误就会变成游离的UnhandledPromiseRejection，根本进不了Express的错误处理链路，自然触发不了你写的errorHandler。
• 这类游离错误没有任何代码负责返回HTTP响应，所以Postman的请求会一直干等直到超时，和你遇到的“请求卡住无响应”的现象完全对得上。

常见的问题触发场景 #

写Express路由时直接在async函数里调用Mongoose方法，却没加任何错误捕获逻辑，是这类问题的高发场景，示例代码如下：

// 存在问题的路由写法
app.post('/api/items', async (req, res) => {
  // 缺少必填的type字段，触发Mongoose schema校验
  const newItem = new Item(req.body);
  await newItem.save(); // 这里抛出的ValidationError没有被任何catch接住
  res.status(201).json(newItem);
});

因为async函数内部抛出的错误会被包裹为Promise rejection，如果没有显式的.catch()或try/catch接住，Express根本感知不到这个错误的存在，自然不会把它传递给错误处理中间件。

修复方案 #

方案1：在路由逻辑中手动捕获错误并传递 #

给所有包含Mongoose异步操作的路由加上try/catch块，把捕获到的错误通过next(err)传给Express的错误链路：

app.post('/api/items', async (req, res, next) => {
  try {
    const newItem = new Item(req.body);
    await newItem.save();
    res.status(201).json(newItem);
  } catch (err) {
    // 显式将错误传递给后续错误处理中间件
    next(err);
  }
});

方案2：用通用异步包装器减少重复代码 #

如果项目路由数量多，逐行加try/catch会产生大量冗余代码，可以写一个通用的异步处理包装器，自动捕获异步路由中的Promise rejection并传给next：

// 通用异步包装器
const asyncHandler = (routeFn) => (req, res, next) => {
  Promise.resolve(routeFn(req, res, next)).catch(next);
};

// 路由写法
app.post('/api/items', asyncHandler(async (req, res) => {
  const newItem = new Item(req.body);
  await newItem.save();
  res.status(201).json(newItem);
}));

补充说明：你现有定义的errorHandler中间件本身逻辑没有问题，打通错误传递链路后，就可以正常接住所有Mongoose抛出的错误。后续也可以在这个错误处理函数中加分支判断，把Mongoose的ValidationError（必填字段缺失、格式不匹配等）、CastError（ID格式不合法等）这类客户端错误的响应状态码从默认的500调整为400，进一步优化接口返回的规范性。

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