为何Express中间件无法捕获async/await错误？两类中间件行为差异解析

咱们先从Express的错误处理底层逻辑说起：Express最初是为回调式异步编程设计的，它的错误传递依赖于开发者手动调用next(err)把错误传递给后续的错误处理中间件。对于同步代码里抛出的错误，Express能自动捕获并触发错误流程，但对于异步操作的错误，必须显式调用next(err)才行。

而async/await本质是Promise的语法糖，所有async函数都会返回一个Promise——不管你是主动throw错误，还是await了一个rejected的Promise，最终都会让这个Promise变成rejected状态。但Express 4.x及更早版本并不会自动监听async中间件返回的Promise状态，所以这个rejected的Promise就成了“未处理的Promise拒绝”，自然不会被Express的错误处理机制捕获。

两类中间件写法的差异详解 #

咱们对比你给出的两段代码：

写法1：错误能被捕获

router.get('/force_async_error/0', async function (req, res, next) { 
  try{ 
    await Promise.reject(new Error('my zoom 0')); 
  } catch(err){ 
    next(err); 
  } 
});

这里你用try/catch手动捕获了await触发的Promise拒绝，然后通过next(err)把错误主动传递给了Express的错误处理流程——这完全符合Express原本的错误传递规则，所以错误能被正常捕获处理。

写法2：错误无法被捕获

router.get('/force_async_error/1', async function (req, res, next) { 
  await Promise.reject(new Error('my zoom 1')); 
});

这段代码里，await了一个rejected的Promise，导致整个async函数返回了一个rejected的Promise，但Express 4.x并不会去处理这个Promise的拒绝状态，既不会自动把它转化为错误传递给next，也不会触发错误处理中间件，所以这个错误就“漏掉”了，只会在控制台输出一个“未处理的Promise拒绝”警告。

解决方法 #

如果想让async/await的错误被Express捕获，有几种常用方案：

• 手动包try/catch：像写法1那样，捕获错误后调用next(err)
• 写通用包装函数：封装一个工具函数，自动给async中间件添加错误捕获逻辑，比如：

  const asyncHandler = (fn) => (req, res, next) => {
    Promise.resolve(fn(req, res, next)).catch(next);
  };
  // 使用方式
  router.get('/test', asyncHandler(async (req, res) => {
    await Promise.reject(new Error('test error'));
  }));
  

• 升级到Express 5.x：Express 5会自动处理async中间件返回的Promise，如果Promise被reject，会自动把错误传递给错误处理中间件，不用再手动处理。

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