生产环境异步错误需主动捕获上报并关联上下文：监听unhandledrejection和error事件，补充url、用户id、交互日志等上下文，用fetch+keepalive可靠上报，限流防刷并验证生效。
生产环境异步报错（如 Promise rejection、setTimeout 中抛错、fetch 失败未 catch）默认不会触发 window.onerror，容易静默丢失。要可靠追踪，核心是「主动捕获 + 上报 + 关联上下文」。
捕获所有未处理的异步错误
重点监听两类全局事件：
-
window.addEventListener('unhandledrejection', ...)：捕获未被.catch()或await捕获的 Promise 拒绝。注意 event.reason 可能是 Error 实例，也可能是普通值（如字符串、对象），需兼容处理。 -
window.addEventListener('error', ...)：虽主要捕获同步脚本错误，但配合preventDefault()和手动上报，可增强覆盖（例如某些微任务链断裂场景）。注意它不捕获 Promise rejection，别混淆。
增强错误上下文，避免“黑盒”上报
单纯上报 event.reason.stack 往往信息不足。建议在上报前补充：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 当前 URL、用户 ID（脱敏）、设备类型、SDK 版本；
- 最近一次用户交互（如点击的按钮 text、路由 path）——可用
performance.getEntriesByType('navigation')或自维护简单操作日志栈（长度限制 5 条）； - 若 error 是 Error 实例，用
error.toString() + '\n' + error.stack；否则JSON.stringify(event.reason)防止序列化失败。
确保上报不因错误本身而失败
错误发生时，JS 执行环境可能已不稳定。上报逻辑必须：
- 使用原生
fetch(..., { method: 'POST', keepalive: true })，keepalive: true确保页面卸载时仍能发出请求； - 避免依赖第三方库（如 axios）或复杂工具函数；
- 加 try/catch 包裹整个上报体，并设置超时（如 3s 后放弃）；
- 对上报频率做简单限流（如 1 分钟内同错误类型最多报 3 次），防刷量。
验证是否生效的轻量方法
上线前本地模拟：
- 在控制台执行：
setTimeout(() => Promise.reject(new Error('test async error')), 0)，看是否触发unhandledrejection监听器； - 故意写一个
fetch('/404').then(r => r.json()).catch(() => {})（不处理 reject），再改成不 catch，确认错误被捕获； - 检查 Network 面板是否有上报请求发出，响应状态是否为 200。
不复杂但容易忽略：异步错误追踪的关键不在“能不能捕”，而在“捕到后有没有足够线索定位”。补全上下文比堆砌监控工具更重要。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
