Express 5异步处理函数抛出异常为何无法传递至next处理函数？

你的代码逻辑符合Express 5的设计，但错误处理中间件未触发，大概率是以下原因之一：

1. 你安装的不是Express 5版本 #

Express 4及更早版本不会自动捕获async路由处理函数抛出的错误，只有Express 5支持该特性。先确认当前版本：

npm list express

如果显示为4.x.x，要么升级到Express 5，要么手动处理async函数的错误。

升级到Express 5 #

由于Express 5目前处于beta阶段，需要安装@next标签版本：

npm install express@next

2. 错误处理中间件未结束响应（Express 5环境下） #

即使错误被传递到处理中间件，若未主动结束响应，请求会处于挂起状态，也可能导致日志输出异常。修改错误处理中间件，添加响应逻辑：

app.use(async (err, req, res, next) => {
  console.log('Error happened!');
  console.log(err);
  // 必须结束响应，避免请求挂起
  res.status(500).send('服务器内部错误');
});

3. Express 4兼容方案（不想升级时） #

在Express 4中，需手动捕获async函数的错误并传递给next，有两种方式：

方式1：在控制器内手动捕获 #

export const index = async (req, res, next) => {
  try {
    throw new Error('mine');
  } catch (err) {
    next(err);
  }
};

方式2：使用通用包装函数（推荐） #

写一个统一处理async路由错误的包装器，避免重复写try/catch：

// 通用异步处理包装函数
const asyncHandler = (fn) => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

// 在路由中使用包装后的控制器
router.route('/').get(asyncHandler(homeController.index));

额外排查点 #

• 确认错误处理中间件放在所有路由和其他中间件之后（你的代码顺序正确，无需调整）。
• 在homeController.index中添加console.log('控制器已调用')，确认请求确实进入了该函数。

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