为何Node.js Express中间件无法正确捕获async/await抛出的错误？

哥们，我太懂你遇到的这个坑了！在Express里用async/await写路由的时候，直接throw错误确实不会被默认的错误处理中间件捕获，这是因为async函数本质上返回的是一个Promise，而Express的普通路由处理器并不会自动处理Promise的rejection——你抛出的错误会被包装成Promise的reject状态，但Express没监听这个状态，自然就不会把错误传给你的错误处理中间件。

下面给你几个靠谱的解决方案：

方法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); // simulate missing user
    }, 100);
  });
}

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

方法2：写一个通用的异步路由包装器 #

如果你的项目里有很多异步路由，每个都写try/catch会很冗余，这时候可以写一个包装函数，自动捕获async路由的错误并传给next：

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

// 通用的异步路由包装器
const wrapAsync = (handler) => {
  return (req, res, next) => {
    // 调用async handler，捕获rejection并传给next
    handler(req, res, next).catch(next);
  };
};

// 用包装器包裹你的异步路由
app.get('/user', wrapAsync(async (req, res, next) => {
  const user = await getUserFromDatabase(req.query.id);
  if (!user) {
    throw new Error('User not found');
  }
  res.json(user);
}));

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); // simulate missing user
    }, 100);
  });
}

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

这个包装器的原理是利用Promise的.catch()方法，把async函数抛出的错误（也就是Promise的reject值）直接传给next，这样错误就会被你的错误处理中间件捕获了。

方法3：升级到Express 5（Beta版本） #

如果你愿意尝试Beta版本的话，Express 5已经默认支持处理async路由的Promise rejection了——它会自动把Promise的reject值作为错误传给错误处理中间件，不用你手动做任何额外处理。不过因为是Beta版本，可能存在一些不稳定的地方，生产环境要谨慎使用。

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