Express Node.js错误中间件问题：next()无法捕获错误，该方案为何失效？如何为API创建错误防护中间件？

咱们先拆解下你的方案为啥没生效：

失效核心原因 #

1. 同步try/catch抓不到异步错误
   你的ErrorCatcherMiddleware里用了同步的try/catch包裹next()，但Express路由和业务逻辑里大多是异步操作（比如数据库查询、async/await函数、Promise调用）。当这些异步代码抛出错误时，错误会进入JavaScript的异步任务队列，同步的try/catch根本感知不到，自然无法捕获。

2. 中间件逻辑定位偏差
   你写的这个中间件本质上是想做“错误捕获”，但它没有正确处理异步代码的错误传递，而且如果它挂载在路由之前，路由里的异步错误也不会冒泡回这个中间件的同步上下文。

正确的错误防护实现方式 #

针对Express的错误处理，我们需要分两步走：捕获异步路由的错误 + 全局统一处理错误。

1. 异步路由错误捕获包装器 #

写一个高阶函数，专门包装你的异步路由处理函数，自动捕获异步错误并传给next(err)：

// 异步错误捕获包装器
export const asyncHandler = (fn: (req: Request, res: Response, next: NextFunction) => Promise<any>) => {
  return (req: Request, res: Response, next: NextFunction) => {
    // 捕获异步函数的错误，直接传给next
    fn(req, res, next).catch(next);
  };
};

使用方式：在定义路由时用这个包装器包裹你的异步处理函数：

// 示例路由
app.get('/api/user', asyncHandler(async (req, res) => {
  // 模拟异步操作，比如查询数据库
  const user = await User.findById(req.params.id);
  if (!user) {
    // 主动抛出自定义错误
    throw new Error('用户不存在');
  }
  res.json(user);
}));

2. 全局错误处理中间件 #

Express规定，全局错误处理中间件必须有4个参数（err, req, res, next），它会接收所有通过next(err)传递的错误，统一处理响应：

// 全局错误处理中间件
export const globalErrorHandler = (err: Error, req: Request, res: Response, next: NextFunction) => {
  console.error('请求处理失败:', err);
  
  // 根据环境返回不同的错误信息（生产环境隐藏细节）
  const errorMessage = process.env.NODE_ENV === 'development' 
    ? err.message 
    : '服务器内部错误';

  res.status(500).json({
    success: false,
    message: errorMessage
  });
};

关键注意点：这个中间件必须放在所有路由和其他中间件的最后，这样才能捕获前面所有中间件和路由抛出的错误：

// 先挂载路由和其他业务中间件
app.use('/api', userRoutes);
app.use('/api', postRoutes);

// 最后挂载全局错误处理中间件
app.use(globalErrorHandler);

额外说明：Express 5+的简化处理 #

如果你用的是Express 5.x版本，它已经自动支持捕获异步路由函数的错误，并自动传给全局错误处理中间件，不需要手动写asyncHandler包装器。但目前大部分项目还是用Express 4.x，所以上面的方案依然适用。

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