前端异常监控:从 window.onerror 到 sourcemap,四处漏一个都白装

更新时间:2026-11-22 13:28:27

访问次数:9

详细介绍
一句话结论:前端异常监控只要抓住四个入口——window.onerror、资源加载错误(必须用捕获阶段)、unhandledrejection、以及 sourcemap 还原;漏掉任何一个,你看到的报错都会是「Script error.」这种没法查的东西。

第一层:window.onerror 抓运行时错误

最基础的一行是 window.onerror,它能拿到 message、文件名、行号、列号和错误对象。但它有个致命短板:跨域脚本抛出的错误,浏览器出于安全考虑会把信息抹成一句「Script error.」,行号列号全是 0。这不是 SDK 的问题,是浏览器规范。

解决办法有两个,必须同时做:脚本标签加 crossorigin="anonymous",并且 CDN 返回 Access-Control-Allow-Origin 头。两个条件缺一个,错误信息就还是被抹掉。我见过太多站点只加了 crossorigin 却忘了配响应头,结果监控装了跟没装一样。

第二层:资源加载错误不冒泡

图片、script、link、iframe 加载失败触发的是资源事件,它不冒泡到 window,所以 addEventListener("error") 的第三个参数必须传 true,走捕获阶段才能收到。这是前端监控里最常见的漏报来源——页面图片 404 一片,监控后台一条都没有。

捕获到之后,event.target 是出问题的元素而不是 window,要判断 target 是 IMG 还是 SCRIPT 再分别处理;同时记得过滤掉浏览器插件、用户网络劫持造成的噪音,不然误报会把告警淹没。

第三层:Promise 异常单独接

unhandledrejection 是独立事件,window.onerror 收不到它。现在的代码大量用 async/await,一个没 catch 的 Promise 拒绝就是一次静默失败。接的时候注意 event.reason 可能是 Error,也可能是字符串、对象甚至 undefined,上报前要统一成可读结构。

还有一个容易忽略的点:上报本身要用 navigator.sendBeacon(),它不会阻塞页面卸载。用 fetch 或 XHR 在 unload 阶段发请求,页面一关就被浏览器掐掉,你会丢掉「用户关页面那一刻」的错误——而那往往是最有价值的一批。

第四层:sourcemap 决定你能不能看懂堆栈

线上代码是压缩过的,堆栈里的 a.b.c 看不出任何东西。正确做法是构建时生成 sourcemap,上传到 Sentry / GlitchTip 这类平台并绑定 release 版本,然后从发布产物里删掉 .map 文件,同时去掉文件末尾的 sourceMappingURL 注释。

这里有个安全细节:sourcemap 里是完整源码,直接公开等于把代码送人。上传到平台、产物里删除,两步都要做。另外 release 号必须和实际上线的构建一致——版本号对不上,平台就无法把堆栈映射回源码,等于白传。

前端异常监控:从 window.onerror 到 sourcemap,四处漏一个都白装

图:Sentry 文档的 Source Maps 页,写的是把 sourcemap 上传后才能在堆栈里看到出错的具体行

额度、采样与去重

免费额度决定了你能收多少条:Sentry 免费档每月 5,000 条,折合每天 166 条;GlitchTip Hobby 是 1,000 条/月,每天 33 条。听起来很少,但前端错误的特征是「同一个 bug 循环报」——一个渲染循环出错,几分钟就能打出上千条。所以必须做三件事:

  • 前端只上报 error 和 unhandledrejection,不接管 console.log;
  • 按「message + 顶层堆栈 + 页面路径」生成指纹去重,同一指纹 5 分钟内只报一次;
  • 在 SDK 侧设速率上限,比如每分钟最多 20 条,超了就只累计计数。

我的取舍:宁可少收,也要保证每条都能查。一个能点开看到源码行、看到用户操作路径的错误,比一万条重复的「undefined is not a function」有用得多。

网友评论