JavaScript异步错误易静默丢失，因不走同步调用栈且不触发try/catch或window.onerror；需建立分层捕获（unhandledrejection/error事件）、上下文追踪（traceId、路由、用户ID等）与可靠上报（sendBeacon优先+降级+节流+本地缓存）闭环。
JavaScript 异步错误容易静默丢失，根本原因在于它们不走同步调用栈，未被显式捕获时不会中断主线程，也不会触发传统 try/catch 或 window.onerror。要避免程序“看似正常、实则失效”的静默崩溃，关键不是堵住所有错误，而是建立分层防御+上下文可追溯+上报必达的闭环。
分清错误类型，匹配对应捕获机制
不同来源的异步错误传播路径不同，需对症下药：
-
Promise 拒绝（含 async/await 抛错）：必须监听
unhandledrejection事件。注意调用event.preventDefault()阻止控制台默认警告，但别跳过上报；event.reason可能是字符串、数字或 Error 实例，需做类型判断再取.stack或.message -
定时器、事件监听器中抛出的异常（如
setTimeout(() => { throw new Error('boom') })）：这类错误不会触发unhandledrejection，但会被window.addEventListener('error')捕获，需确保该监听器已注册 -
资源加载失败（如 script、img 加载 404）：同样归
error事件管，可通过event.filename和event.lineno定位问题资源
顶层 Promise 必须兜底，不能“悬空调用”
常见静默崩溃场景是 async 函数被调用后没接 .catch() 或没在顶层 await，例如：
❌ 错误写法loadUser().then(showProfile); // loadUser 内部 reject，这里没 catch
✅ 正确做法
在调用链末端补上 .catch()，或统一在应用入口处挂全局兜底：
- 浏览器端：
window.addEventListener('unhandledrejection', e => {上报(e.reason); e.preventDefault();}) - Node.js 端：
process.on('unhandledRejection', (reason) => {上报(reason);})
增强错误上下文，让静默变“可查”
只捕获堆栈不够，生产环境需要知道“谁、在哪、为什么出错”：
立即学习“Java免费学习笔记（深入）”；
- 发起请求前生成唯一
traceId，透传到请求头和错误上报 payload 中 - 记录当前路由、用户 ID（脱敏）、设备型号、网络状态（
navigator.onLine）、SDK 版本 - 对关键异步操作（如登录、支付）手动打点，比如在
fetch前存一个快照：localStorage.setItem('lastAsyncCall', JSON.stringify({ url, timestamp: Date.now() }))
上报必须可靠，失败也要有退路
错误上报本身不能失败，否则等于没报：
- 优先用
navigator.sendBeacon()发送日志，它支持页面卸载时发送，且不阻塞导航 - 若不可用，降级为
new Image().src = url（GET 请求）或fetch(url, { keepalive: true }) - 高频错误做节流（如 1 分钟内同类错误超 5 次只报 1 条），本地
localStorage缓存未发出的错误，下次打开页面时补报
