首页 > 网页制作 >全局未捕获异常：用unhandledrejection拦截async未处理错误

全局未捕获异常：用unhandledrejection拦截async未处理错误

来源：互联网 2026-06-24 08:19:00

在 async 函数中抛出、又被外层 try/catch 遗漏的错误，是否能在全局层面统一截获？答案是肯定的，但必须使用正确的机制——unhandledrejection 正是为 Promise 拒绝而生的兜底事件。它不是某种“错误网关”，而是浏览器和 Node.js 各自内置的标准事件，专门处理那

在 async 函数中抛出、又被外层 try/catch 遗漏的错误，是否能在全局层面统一截获？答案是肯定的，但必须使用正确的机制——unhandledrejection 正是为 Promise 拒绝而生的兜底事件。它不是某种“错误网关”，而是浏览器和 Node.js 各自内置的标准事件，专门处理那些未被 .catch() 或 await 捕获的 Promise。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

简单来说，只要在应用启动时尽早注册一个监听器，就能将那些从 async 函数逃逸、未被 try/catch 或 .catch() 处理的错误全部拦截。但它并非用于“治理”业务逻辑，而是一条最后防线。

浏览器端：使用 window.addEventListener 注册监听

最标准、最稳妥的做法是在页面加载的极早阶段（如内或入口 JS 的首行）挂上监听：

事件类型固定为 'unhandledrejection'
事件对象包含两个关键字段：event.reason（即拒绝值，通常是 Error 实例）和 event.promise（出问题的 Promise 对象）
调用 event.preventDefault() 可抑制浏览器控制台的黄色警告，但不影响其他监听器继续执行

Node.js 端：使用 process.on 替代

Node.js 的实现方式不同。从 v15 版本起，未监听的 unhandledRejection 会直接导致进程崩溃：

使用 process.on('unhandledRejection', (reason, promise) => { ... })
强烈建议同时监听 'rejectionHandled' 事件，它用于发现“延迟补 catch”的情况——比如某个 Promise 被拒绝后，过了几毫秒才加上 .catch()，此时前者触发 unhandledRejection，后者触发 rejectionHandled
注意：这里不适合恢复业务逻辑，只适合执行日志、上报、告警等无侵入操作

它能捕获什么，不能捕获什么

清楚边界才能避免踩坑：

能捕获：async 函数内 throw new Error() 但外层没有 try/catch 的情况；Promise.reject() 后未接 .catch() 或 await 的场景
不能捕获：同步错误（需使用 window.onerror）、已经处理过的 Promise（哪怕延迟几毫秒加上 .catch() 即视为已处理）、跨域脚本错误、资源加载失败、框架内部封装过的错误（如 Vue 渲染异常）
特别提醒：event.reason 不一定总是完整的堆栈信息，尤其是当 reject 的值是普通字符串或对象时。建议在 async 函数内部主动使用 try/catch，而不是完全依赖全局监听