Node.js Express中间件中async/await错误无法正确捕获的问题咨询

嘿，这个问题我之前也踩过坑——Express 默认不会自动捕获异步路由处理器中抛出的错误，因为异步函数的异常会被封装成 Promise 的 reject 状态，而 Express 并不会主动去处理这个 reject。下面给你几种实用的解决方案：

方法1：用 try/catch 包裹异步逻辑，手动传递错误给 next() #

把你的异步代码放在 try 块里，一旦捕获到错误就调用 next(err)，把错误交给后面的错误处理中间件：

const express = require('express');
const app = express();

app.get('/user', async (req, res, next) => {
  try {
    const user = await getUserFromDatabase(req.query.id);
    if (!user) {
      throw new Error('User not found');
    }
    res.json(user);
  } catch (err) {
    // 把错误传递给错误处理中间件
    next(err);
  }
});

app.use((err, req, res, next) => {
  console.error(err.message);
  res.status(500).json({ error: err.message });
});

function getUserFromDatabase(id) {
  return new Promise((resolve, reject) => {
    setTimeout(() => {
      resolve(null); // 模拟用户不存在的情况
    }, 100);
  });
}

app.listen(3000, () => console.log('Server running'));

方法2：利用 Promise 的 catch 方法传递错误 #

如果你不想写 try/catch，也可以直接在 await 的 Promise 后面链式调用 .catch(next)，这样 Promise 的 reject 会直接传给 next()：

app.get('/user', async (req, res, next) => {
  // 捕获数据库查询的错误
  const user = await getUserFromDatabase(req.query.id).catch(next);
  if (!user) {
    // 这里的同步错误还是需要 try/catch 包裹
    try {
      throw new Error('User not found');
    } catch (err) {
      next(err);
    }
  }
  res.json(user);
});

不过这种方式要注意：同步抛出的错误（比如上面的throw new Error）还是需要单独处理，不然还是无法被捕获，所以更稳妥的还是结合 try/catch 一起用。

方法3：创建通用的异步路由包装函数 #

如果你的项目里有大量异步路由，重复写 try/catch 会很繁琐。可以写一个通用的包装函数，自动捕获异步路由的错误并传给 next()：

// 自定义异步路由包装器
const asyncHandler = (fn) => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

// 使用包装器简化路由代码
app.get('/user', asyncHandler(async (req, res) => {
  const user = await getUserFromDatabase(req.query.id);
  if (!user) {
    throw new Error('User not found');
  }
  res.json(user);
}));

这个包装器会把你的异步路由函数转换成一个返回 Promise 的函数，自动捕获所有 reject 状态的错误并传递给错误处理中间件，这样你就不用在每个路由里重复写 try/catch 了。

当然，你也可以直接用社区现成的包，比如 express-async-handler，原理和上面的包装器完全一样，省去自己写的麻烦。

为什么原来的代码不生效？ #

简单来说：当你在异步函数里抛出错误时，这个错误会变成函数返回的 Promise 的 reject 值，但 Express 的默认路由处理器不会去处理这个 reject，所以错误就“丢失”了，根本传不到你的错误处理中间件里。只有手动调用 next(err)，或者让Express感知到这个 Promise 的 reject，错误才会被正确捕获处理。

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