如何在Express中无需try/catch/next实现全局错误处理

1. 确保错误处理中间件正确配置 #

首先，将全局错误处理中间件放在所有路由和其他中间件的最后，确保能捕获所有请求流程中的错误：

// 必须放在所有路由、中间件之后
app.use((err, req, res, next) => {
  // 自定义错误响应格式
  const statusCode = err.statusCode || 500;
  const response = {
    message: err.message || '服务器内部错误'
  };

  // 开发环境返回错误栈，方便调试
  if (process.env.NODE_ENV === 'development') {
    response.stack = err.stack;
  }

  res.status(statusCode).json(response);
});

2. 处理同步路由错误 #

同步路由中直接抛出错误即可，Express会自动将错误传递给全局错误处理中间件，无需额外处理：

router.get('/sync-error', (req, res) => {
  // 直接抛错，会被全局中间件捕获
  throw new Error('这是一个同步错误');
});

3. 处理异步（async/await）路由错误 #

Express 4.x不会自动捕获async函数中抛出的错误（这类错误会转为Promise的reject状态），可以通过以下两种方式解决：

方案A：每个路由后添加.catch(next) #

无需额外包装函数，直接在async函数后链式调用.catch(next)，将错误传递给Express的错误处理流程：

router.get('/async-error', async (req, res) => {
  const result = await someAsyncTask();
  if (!result) {
    throw new Error('异步操作失败');
  }
  res.json(result);
}.catch(next)); // 捕获async函数的reject，传给next

方案B：全局包装中间件（避免重复代码） #

如果觉得每个路由加.catch(next)繁琐，可以写一个通用包装函数，一次性处理所有async路由：

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

// 注册路由时使用
router.get('/async-error', asyncHandler(async (req, res) => {
  const result = await someAsyncTask();
  if (!result) {
    throw new Error('异步操作失败');
  }
  res.json(result);
}));

方案C：升级到Express 5.x #

Express 5.x已原生支持自动捕获async函数的rejected Promise，async路由中抛出的错误会直接进入全局错误处理中间件，无需任何额外代码：

// Express 5.x 环境下直接编写async路由
router.get('/async-error', async (req, res) => {
  const result = await someAsyncTask();
  if (!result) {
    throw new Error('异步操作失败');
  }
  res.json(result);
});

额外优化：自定义错误类 #

可以继承原生Error类创建自定义错误，方便携带状态码等信息：

class CustomError extends Error {
  constructor(message, statusCode) {
    super(message);
    this.statusCode = statusCode;
    this.name = 'CustomError';
  }
}

// 使用示例
throw new CustomError('资源不存在', 404);

注意事项 #

• process.on('uncaughtException')是进程级错误捕获，无法获取请求上下文（req/res），且触发后进程状态不稳定，不适合处理请求级错误。
• 错误处理中间件的顺序必须在所有路由之后，否则无法捕获前面路由的错误。

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