Node.js 官方文档明确建议，uncaughtException 监听器中只应执行同步资源清理并立即退出进程，不要试图在此处恢复服务或执行复杂异步操作。适用场景是进程崩溃前的最后止损，风险边界是异步资源可能因事件循环中断而无法完全释放。

命令速用版

此处为代码逻辑而非 shell 命令，以下是最小化监听器实现：

process.on('uncaughtException', (err) => {
  console.error('Uncaught Exception:', err);
  if (server && typeof server.close === 'function') {
    server.close();
  }
  process.exit(1);
});

为什么会这样

uncaughtException 触发时事件循环可能已处于不一致状态，异步回调无法保证执行。

Node.js 进程中异步资源依赖事件循环驱动，当抛出未捕获异常时，运行时认为当前执行上下文已损坏。此时若继续执行异步清理代码，可能因堆栈损坏导致清理逻辑本身报错，或者资源句柄被锁死。

分步处理

按照以下顺序编写异常处理逻辑，确保进程能安全终止：

1. 注册监听器：在应用启动初期注册 process.on('uncaughtException')，避免遗漏。
2. 同步日志：使用 console.error 或同步日志库记录错误堆栈，避免异步日志丢失。
3. 关闭服务：调用 HTTP 服务器的 close 方法停止接收新请求，不要等待连接完全断开。
4. 强制退出：设置超时计时器，若 5 秒内未退出则调用 process.exit(1) 强制终止。

怎么验证是否生效

通过日志输出和端口状态检查确认进程退出行为：

• 查看标准错误输出是否打印了异常堆栈信息。
• 使用 lsof -i :端口号 命令确认进程退出后端口不再被占用。
• 检查进程退出码，非 0 值表示异常退出。

常见坑

• 不要在监听器中忽略错误直接继续运行，这会导致数据损坏。
• 避免在异常处理中执行数据库写入等异步操作，可能无法完成。
• 不要依赖 uncaughtException 处理 Promise 拒绝，需单独监听 unhandledRejection。

常见问题

uncaughtException 和 unhandledRejection 有什么区别？

uncaughtException 捕获同步代码或未绑定处理器的异步错误，unhandledRejection 专门捕获 Promise 拒绝。

进程退出后资源一定会释放吗？

操作系统通常会回收进程占用的文件描述符和内存，但网络连接可能处于半开状态。

可以在 uncaughtException 中重启进程吗？

不建议在进程内重启，应使用外部守护进程如 PM2 或 systemd 管理进程生命周期。

参考来源

• Node.js Official Documentation, process.html, Event: 'uncaughtException', https://nodejs.org/api/process.html#event-uncaughtexception
• Node.js Official Documentation, errors.html, Error Handling, https://nodejs.org/api/errors.html#error-handling