async函数错误监控的核心是精准拦截、分层处理、轻量上报:顶层显式try-catch+上下文快照,promise链末端统一打点,unhandledrejection兜底,分级去重缓存上报。

在 async 函数中实现高性能的异步错误监控,核心不是“捕获所有错误”,而是精准拦截、分层处理、轻量上报。关键在于避免全局 try-catch 套壳、拒绝日志刷屏、防止监控逻辑拖慢主流程。
顶层显式 try-catch + 上下文快照
只在真正对外暴露的 async 入口处(如按钮点击事件、API 调用函数)加 try-catch,而非每个内部 await 都包一层。catch 中不只记录 error.message,而是立即提取可追溯字段:
- 生成唯一 errorId(UUID v4),用于前后端链路对齐
- 补充 context:调用位置(
fn.name+new Error().stack.split('\n')[1])、触发动作(如'click-submit')、关键参数摘要(如{ userId: 'u_abc', orderId: 'o_123' }) - 保留原始 stack,但截断超过 5 行或过滤含
node_modules/的路径,减小体积
Promise 链末端统一打点
async 函数返回 Promise,监控应作用于该 Promise 的生命周期,而非函数体本身。用 Reflect.apply 触发调用后,在 then/catch 中计算耗时并上报:
- 起始时间用
performance.now(),非Date.now() - 成功时上报
{ status: 'success', duration, resultType: typeof result } - 失败时上报
{ status: 'error', duration, errorName: error.name, errorMsg: error.message } - 所有上报走
sendBeacon或节流队列,不阻塞渲染
unhandledrejection 兜底但不依赖
监听 unhandledrejection 是必要的最后一道防线,但必须明确它只抓“漏网之鱼”:
- 注册要在脚本最开始执行,早于任何 async 初始化逻辑
- 上报字段与顶层 try-catch 对齐(
errorId、context、stack),保持日志结构一致 - 对
event.reason做类型判断:若为普通 Error 实例才上报;若为字符串或 null,降级为 warn 级别并标记type: 'raw-reason' - 调用
event.preventDefault()防止浏览器默认报错弹窗
分级+去重+缓存上报策略
高频操作(如输入联想、滚动加载)若每次错误都直报,会压垮日志服务:
- 按错误类型分流:
fetch-fail记录但不告警;runtime-error(如 Cannot read prop)计入错误率看板;business-reject(如 400 code)归为 warn - 相同 stack hash 在 5 分钟内只上报一次,用
localStorage存最近 10 条 hash 做本地去重 - 非关键错误暂存 localStorage,页面卸载前或空闲时(
requestIdleCallback)批量发出 - 连续 3 次同一
errorId出现,触发采样式堆栈快照(截取当前所有 task + pending promise)











