JavaScript 中 Node.js 中 process.on(‘unhandledRejection’) 怎么优雅闭合服务并日志记录-js教程-PHP中文网

unhandledRejection 用于捕获未处理的 Promise 拒绝，需记录完整错误日志、触发优雅关闭（如 server.close()）、配合 uncaughtException 并禁用默认退出行为，避免资源泄漏。

$javascript 中 node.js 中 process.on(\'unhandledrejection\') 怎么优雅闭合服务并日志记录$

在 Node.js 中，process.on('unhandledRejection') 是捕获未被 catch 的 Promise 拒绝的关键钩子。它本身不终止进程，但若放任不管，可能导致服务处于不可预期状态（如内存泄漏、连接堆积、响应挂起）。要“优雅闭合服务并日志记录”，核心是：**及时记录错误 + 主动触发服务关闭流程 + 避免强制退出（如 process.exit()）导致资源未释放**。

明确 unhandledRejection 的定位与限制

该事件仅捕获未被 catch 或 .finally() 后续处理的 Promise rejection，不是兜底错误处理器。它不捕获同步异常、未捕获的异常（uncaughtException）或底层系统错误。因此需配合 uncaughtException 使用，且两者都应作为最后防线，而非替代良好的 Promise 错误处理习惯。

记录错误日志（含上下文与堆栈）

记录时不能只打 reason，要保留完整信息便于排查：

Node.js 可靠编程

Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。

下载

使用结构化日志库（如 pino 或 winston），避免拼接字符串
记录 reason 的 message、stack、name；若 reason 是对象，用 util.inspect(reason, { depth: 6 }) 安全序列化
添加时间戳、进程 PID、环境标识（如 process.env.NODE_ENV）
示例（使用 pino）：
logger.error({ err: reason, event: 'unhandledRejection' }, 'Unhandled promise rejection');

触发优雅关闭（Graceful Shutdown）

不能直接 process.exit(1)。应交由已实现的关闭逻辑执行：

确保你的 HTTP server（如 Express、Fastify）、数据库连接池、消息队列客户端等都支持 close() / destroy() 方法，并封装统一的 shutdown() 函数
在 unhandledRejection 回调中，调用该函数，并传入错误原因用于日志上下文
设置超时兜底（如 30 秒），超时后强制退出，防止无限等待

示例伪代码：

process.on('unhandledRejection', async (reason, promise) => {<br>  logger.error({ err: reason }, 'Unhandled rejection, starting graceful shutdown');<br>  await shutdown({ reason }); // 包含 server.close(), db.end() 等<br>});