Node.js 如何优雅地处理未捕获异常？

Question

仓乃文 · Accepted Answer

未捕获异常会导致 Node.js 进程崩溃，通过监听 uncaughtException 和 unhandledRejection 事件可以兜底处理，但最佳实践是做好局部错误处理。

全局兜底处理（最后防线）：
```javascript
// 捕获未处理的 Promise 拒绝
process.on("unhandledRejection", (reason, promise) => {
  console.error("未处理的 Promise 拒绝:", reason);
  // 记录日志后优雅关闭
  gracefulShutdown();
});

// 捕获未捕获的同步异常
process.on("uncaughtException", (error) => {
  console.error("未捕获的异常:", error);
  // uncaughtException 后进程状态不确定，必须重启
  process.exit(1);
});
```

Express 全局错误中间件（推荐）：
```javascript
// 放在所有路由之后
app.use((err, req, res, next) => {
  console.error("服务器错误:", err.message);
  res.status(err.status || 500).json({
    error: process.env.NODE_ENV === "production"
      ? "服务器内部错误"
      : err.message
  });
});
```

异步错误包装器（避免重复 try/catch）：
```javascript
// 自动捕获 async 路由中的异常
const asyncHandler = (fn) => (req, res, next) => {
  Promise.resolve(fn(req, res, next)).catch(next);
};

app.get("/users", asyncHandler(async (req, res) => {
  const users = await db.query("SELECT * FROM users");  // 异常自动传给 next
  res.json(users);
}));
```

补充说明：
- uncaughtException 触发后进程状态不确定，必须重启
- unhandledRejection 在 Node 15+ 默认会终止进程
- Express 错误中间件必须有 4 个参数 (err, req, res, next)
- 生产环境推荐用 PM2 自动重启崩溃的进程