Node.js Express简化异步错误捕获：路由中间件挂起问题求助

问题原因分析 #

你在Source Code 2中直接将catchAsyncErrors作为usersRouter的中间件使用导致应用挂起的核心原因：
catchAsyncErrors是一个高阶函数——它需要接收路由处理函数作为参数，返回一个包装后的中间件函数。但当你调用usersRouter.use(catchAsyncErrors)时，Express会直接把req、res、next三个参数传入catchAsyncErrors，而非传入它返回的包装函数。这就导致catchAsyncErrors内部的fn实际上是req对象，根本无法执行后续路由逻辑，请求自然会挂起。

解决方案：自动包装所有路由处理函数 #

我们可以通过遍历路由栈，自动将所有路由处理函数用catchAsyncErrors包装，无需手动逐个添加。

修改后的完整代码 #

const express = require('express');
const app = express();
const usersRouter = express.Router();
const port = 3000;

const users = [
  // { id: 1, name: 'John Doe' },
  // { id: 2, name: 'Jane Doe' },
];

const getList = () => {
  if (users.length === 0) {
    throw new Error('No users found');
  }
  return users.map(user => ({ id: user.id, name: user.name }));
};

const catchAsyncErrors = fn => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

// 新增：自动包装路由处理函数的工具函数
const wrapRouterHandlers = (router) => {
  router.stack.forEach(layer => {
    // 只包装路由处理函数，跳过其他中间件
    if (layer.route && layer.route.stack.length) {
      layer.route.stack.forEach(routeLayer => {
        routeLayer.handle = catchAsyncErrors(routeLayer.handle);
      });
    }
  });
};

app.use(express.json());

// 定义路由，无需手动包裹catchAsyncErrors
usersRouter.get('/', async (req, res) => {
  const list = getList();
  res.status(200).json(list);
});

usersRouter.post('/', async (req, res) => {
  const { name } = req.body;
  if (!name) {
    throw new Error('Name is required');
  }
  const id = users.length + 1;
  users.push({ id, name });
  res.status(201).json({ id, name });
});

// 路由定义完成后，调用工具函数包装所有处理函数
wrapRouterHandlers(usersRouter);

app.use('/users', usersRouter);

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

module.exports = app;

方案说明 #

1. 保留原有catchAsyncErrors逻辑：它依然负责捕获单个异步函数的错误，并传递给全局错误处理中间件。
2. 新增wrapRouterHandlers工具函数：遍历路由栈中的所有路由处理函数，自动用catchAsyncErrors包装，实现全局批量处理。
3. 路由定义更简洁：无需在每个路由前手动添加catchAsyncErrors，保持代码清爽。

另一种简化方案：全局异步错误捕获中间件 #

如果你不想遍历路由栈，也可以直接写一个全局中间件，捕获所有后续路由的异步错误：

const catchAllAsyncErrors = (req, res, next) => {
  const originalNext = next;
  // 重写next方法，捕获异步路由的Promise错误
  next = function () {
    const result = originalNext.apply(this, arguments);
    if (result instanceof Promise) {
      result.catch(err => originalNext(err));
    }
    return result;
  };
  originalNext();
};

// 在路由前使用该中间件
usersRouter.use(catchAllAsyncErrors);

这种方式无需修改路由定义，直接在路由前挂载中间件即可，同样能实现全局捕获异步错误的效果。

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