你的浏览器无法正常显示内容,请更换或升级浏览器!

Node.js 异常处理与进程崩溃防护备忘

tenfei
tenfei
发布于2026-11-17 16:24 阅读13次
Node.js 异常处理与进程崩溃防护备忘
记录 Node.js 中同步与异步异常的正确捕获方式,以及 uncaughtException 与 unhandledRejection 两个全局兜底事件的使用原则,并总结全局监听只打印不退出、Express 异步路由漏接、日志缺堆栈、敏感信息入库等高频坑与推荐做法。
# Node.js 异常处理与进程崩溃防护备忘 Node.js 服务上线后,一个没接住的异常就能让整个进程退出,用户全部掉线。如何优雅地兜住异常、记录现场、自动恢复,是每个后端开发者都要面对的问题。本文记录几类异常的正确处理方式与常见误区。 ## 一、先分清两类异常 - **同步异常**:用 `try/catch` 就能捕获,比如 JSON 解析失败、访问 undefined 的属性。 - **异步异常**:Promise 的 `reject` 要用 `.catch()` 或 `async/await` 配合 `try/catch`;事件回调里抛出的错误要靠 `error` 事件监听。 最容易出事的是"我以为 catch 住了其实没有"——比如忘记在 `await` 外面加 `try`,或者在回调里抛错却没人接。 ## 二、最后防线:两个全局事件 ```js process.on('uncaughtException', (err) => { console.error('未捕获异常:', err); // 记录日志后立即让进程管理器重启,不要继续运行 process.exit(1); }); process.on('unhandledRejection', (reason, promise) => { console.error('未处理的 Promise 拒绝:', reason); }); ``` > ⚠️ **关键原则**:`uncaughtException` 触发后,进程状态已经不可信,**不要试图继续运行**,正确做法是记录完整错误后退出,交给 PM2 / systemd 这类进程管理器自动拉起。硬撑着继续跑可能导致数据损坏。 ## 三、四个高频坑 > **坑 1:全局监听里只打印不退出** > 有些教程教你在 `uncaughtException` 里打个日志就 return,进程带着未知错误继续跑,内存泄漏、数据错乱接踵而至。记住:兜底是为了优雅退出,不是假装没事。 > **坑 2:Express 路由里的异步错误漏接** > Express 4 不会自动捕获 async 路由函数里 reject 的 Promise,异常会变成 unhandledRejection。要用 `express-async-errors` 或手动 try/catch 后 `next(err)`。 > **坑 3:错误日志没有堆栈** > 只打印 `err.message` 会丢失调用栈,线上根本定位不到是哪行代码。要打印完整 `err.stack`,并带上请求 ID、时间、用户 ID 等上下文。 > **坑 4:把敏感信息写进日志** > 完整打印请求体可能把密码、token 记进日志。记录时要对敏感字段脱敏。 ## 四、推荐做法 用成熟的错误上报服务(Sentry 等)+ 结构化日志( Winston / Pino)+ 进程管理器(PM2)三件套:业务代码里正常 try/catch,全局事件作为最后兜底,报错自动上报并拉起进程。这样既不会因单点异常全站挂掉,也能第一时间拿到可排查的现场。

1

0

文章点评
Copyright © from 2021 by namoer.com
458815@qq.com QQ:458815
蜀ICP备2022020274号-2