03.8.2.2 错误监控与 Sourcemap 还原
所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.8 浏览器原理、性能优化与前端安全 / 03.8.2 数据采集与错误监控
覆盖范围
- 错误采集:JS 异常、Promise 错误、资源加载、接口错误
- Sentry:初始化、breadcrumb、scope、release
- Sourcemap:压缩代码堆栈还原、上传 sourcemap
- 白屏检测:首屏渲染、DOM 节点检查
- 告警:分级、去重、通知
高频题速览
| 编号 | 题目 | 难度 | 频率 |
|---|---|---|---|
| 03.8.2.2-001 | Sentry 如何采集与还原错误 | 进阶 | ★★★★ |
| 03.8.2.2-002 | sourcemap 如何还原堆栈 | 进阶 | ★★★★ |
| 03.8.2.2-003 | 未捕获 JS 异常如何采集 | 基础 | ★★★★ |
| 03.8.2.2-004 | Promise 错误与 unhandledrejection | 进阶 | ★★★ |
| 03.8.2.2-005 | 资源加载错误如何采集 | 基础 | ★★★ |
| 03.8.2.2-006 | 白屏检测如何实现 | 高级 | ★★★ |
| 03.8.2.2-007 | 错误去重与分级 | 进阶 | ★★ |
| 03.8.2.2-008 | 错误监控与隐私 | 进阶 | ★★ |
03.8.2.2-001 Sentry 如何采集与还原错误
一句话结论
Sentry SDK 劫持 window.onerror、unhandledrejection、console.error,采集错误堆栈与上下文(用户、面包屑、release);服务端用 sourcemap 还原堆栈。
概念解释
- SDK:浏览器端初始化。
- 面包屑:错误前的操作轨迹。
- release:版本号,关联 sourcemap。
原理流程
- SDK 初始化 DSN。
- 劫持错误事件。
- 上报到 Sentry。
- 服务端用 sourcemap 还原。
代码 / 示例
import * as Sentry from "@sentry/browser";
Sentry.init({ dsn: "https://...@sentry.io/...", release: "1.0.0" });
常见误区
- 误区:Sentry 自动捕获所有错误;正解:需要初始化,且 iframe 错误需配置。
- 误区:sourcemap 自动上传;正解:需要构建时上传 Sentry,或部署后上传。
追问
- Q:如何设置用户? A:
Sentry.setUser({ id, email })。 - Q:面包屑? A:自动记录点击、导航、请求,可配置。
03.8.2.2-002 sourcemap 如何还原堆栈
一句话结论
压缩代码堆栈是 a.min.js:1:100,sourcemap 文件存原始位置映射;Sentry 用 sourcemap 把压缩位置还原到源码行列号。
概念解释
- sourcemap:
.map文件。 - 映射:压缩位置 → 源码位置。
原理流程
- 构建生成
.map。 - 上传 Sentry。
- 错误上报带压缩位置。
- Sentry 查 sourcemap 还原。
代码 / 示例
// 错误堆栈
// TypeError: Cannot read property 'a' of undefined
// at https://cdn.com/a.min.js:1:100
// Sentry 还原后
// at src/utils.js:42:15
常见误区
- 误区:sourcemap 暴露源码;正解:生产 sourcemap 不上 CDN,只上传 Sentry。
- 误区://# sourceMappingURL 要保留;正解:Sentry 通过 release 关联,可删除 sourceMappingURL 避免暴露。
追问
- Q:如何上传 sourcemap? A:
@sentry/cli在 CI 上传。 - Q:sourcemap 不匹配? A:release 与 dist 必须一致,构建哈希关联。
03.8.2.2-003 未捕获 JS 异常如何采集
一句话结论
用 window.onerror 或 window.addEventListener("error") 捕获未处理异常,收集 message、filename、lineno、colno、error.stack。
概念解释
- window.onerror:返回 true 阻止默认。
- error 事件:包含 error 对象。
原理流程
- 监听 error。
- 收集堆栈。
- 上报。
代码 / 示例
window.addEventListener("error", (e) => {
report({ message: e.message, stack: e.error?.stack, filename: e.filename });
});
常见误区
- 误区:onerror 能捕获所有错误;正解:异步错误需要 unhandledrejection,跨域脚本错误需要 CORS。
- 误区:跨域脚本能拿到堆栈;正解:跨域脚本 onerror 返回 "Script error.",需 script.crossOrigin 与 CORS。
追问
- Q:如何捕获资源错误? A:error 事件在捕获阶段,资源错误不冒泡。
- Q:try/catch 内错误? A:不被 onerror 捕获,需手动上报。
03.8.2.2-004 Promise 错误与 unhandledrejection
一句话结论
Promise reject 没有 catch 时触发 unhandledrejection,采集 reason 与 promise;React/Vue 错误边界另算。
概念解释
- unhandledrejection:未处理拒绝。
- reason:错误原因。
原理流程
- 监听 unhandledrejection。
- 收集 reason。
- 上报。
代码 / 示例
window.addEventListener("unhandledrejection", (e) => {
report({ reason: e.reason });
});
常见误区
- 误区:Promise reject 自动上报;正解:需要监听 unhandledrejection。
- 误区:catch 后还触发;正解:catch 后不触发。
追问
- Q:React Error Boundary? A:捕获渲染错误,不捕获事件与异步。
- Q:Vue errorHandler? A:捕获组件错误,异步错误需 window 监听。
03.8.2.2-005 资源加载错误如何采集
一句话结论
资源加载错误(图片、脚本、CSS)在捕获阶段监听,用 addEventListener("error", handler, true) 捕获。
概念解释
- 资源错误:不冒泡。
- 捕获阶段:捕获资源错误。
原理流程
- document 上监听 error,capture true。
- 判断 target 是元素。
- 上报 URL。
代码 / 示例
document.addEventListener("error", (e) => {
const target = e.target;
if (target.src || target.href) {
report({ type: "resource", url: target.src || target.href });
}
}, true);
常见误区
- 误区:资源错误冒泡;正解:资源错误不冒泡,必须在捕获阶段监听。
- 误区:图片 404 不影响;正解:图片 404 影响体验,需监控。
追问
- Q:接口错误? A:监听 fetch/XHR,或拦截 axios。
- Q:静态资源 CDN 故障? A:资源错误率突增告警。
03.8.2.2-006 白屏检测如何实现
一句话结论
白屏检测:首屏 DOM 节点数小于阈值,或关键元素未渲染,判定白屏;定时检查 + 上报。
概念解释
- 白屏:页面空白。
- 关键元素:如 #root 是否有子节点。
原理流程
- 页面加载后定时检查 DOM。
- 如果 #root 无子节点或节点数少,上报。
- 结合用户会话与性能数据。
代码 / 示例
setTimeout(() => {
const root = document.querySelector("#root");
if (root && root.childElementCount === 0) {
report({ type: "white_screen" });
}
}, 5000);
常见误区
- 误区:白屏就是 JS 错误;正解:白屏可能是 JS 加载失败、CSS 错误、API 卡死。
- 误区:白屏检测立即触发;正解:等待首屏渲染后再判断。
追问
- Q:如何区分白屏与真空白页? A:白屏是预期应有内容但未渲染。
- Q:白屏上报? A:结合 URL、UA、最近错误。
03.8.2.2-007 错误去重与分级
一句话结论
错误按 message + stack + URL 去重,避免同一错误刷屏;分级按影响用户数与严重程度,P0/P1/P2 告警。
概念解释
- 去重:相同错误聚合。
- 分级:P0 全量、P1 部分、P2 单个。
原理流程
- 错误 hash 相同则聚合。
- 统计影响用户数。
- 超阈值告警。
代码 / 示例
const hash = md5(message + stack);
常见误区
- 误区:每个错误都告警;正解:去重 + 阈值告警。
- 误区:堆栈包含动态值;正解:归一化堆栈(去掉数字、字符串)再 hash。
追问
- Q:如何归一化? A:替换数字为 N,字符串为 S。
- Q:告警渠道? A:P0 电话/短信,P1 群消息,P2 邮件。
03.8.2.2-008 错误监控与隐私
一句话结论
错误上报不能包含用户敏感信息(token、密码、身份证),Sentry 提供 scrub 配置;遵守隐私法规。
概念解释
- scrub:自动脱敏。
- PII:个人身份信息。
原理流程
- Sentry 配置 scrub 默认 header。
- 自定义 scrub 敏感字段。
代码 / 示例
Sentry.init({
beforeSend(event) {
if (event.request) {
delete event.request.headers.authorization;
}
return event;
},
});
常见误区
- 误区:上报所有上下文;正解:敏感字段必须脱敏。
- 误区:Sentry 默认脱敏;正解:默认脱敏 header,业务字段需手动。
追问
- Q:如何上报用户信息? A:只上报必要的 id,不上报邮箱手机号。
- Q:GDPR? A:用户数据需可删除,Sentry 提供 Data Deletion。
03.8.2.2-009 Sourcemap 上传策略与版本管理
一句话结论
Sourcemap 不部署到生产环境(避免泄露源码),而是在 CI 构建后上传到 Sentry 等监控平台,通过 release 版本号关联错误堆栈与源码。
概念解释
- release:每次发布的版本号。
- sourcemap 上传:构建产物 .map 文件发到监控平台。
原理流程
- CI 构建生成 dist + .map。
- sentry-cli 上传 .map 到 Sentry。
- 生产环境只部署 dist,不部署 .map。
- 错误上报时带 release,Sentry 自动还原源码。
代码 / 示例
sentry-cli releases new "$VERSION"
sentry-cli sourcemaps upload ./dist
sentry-cli releases finalize "$VERSION"
常见误区
- 误区:.map 放生产环境;正解:可被下载泄露源码。
- 误区:每次上传所有 .map;正解:按 release 增量上传。
追问
- Q:如何验证还原? A:Sentry Issues 页面看到源码位置。
- Q:Sourcemap 太大怎么办? A:只上传线上用到的 chunk,用 --strip-prefix。
待整理清单
- [ ] 性能监控 RUM
- [ ] 错误监控与 APM
- [ ] 前端错误复盘流程
关联与延伸
- 与 03.8.1.5 监控与线上排障配合,本节聚焦错误监控与 sourcemap 还原。
- 与 03.8.2.1 埋点配合,错误监控是技术数据,埋点是业务数据。
- Sentry 是行业标准,理解其原理比记忆 API 更重要。
面试准备要点
- 必须说清 Sentry 工作流程:劫持错误 → 上报 → sourcemap 还原。
- 必须理解 sourcemap 还原:压缩位置 → 源码行列号。
- 常见追问:未捕获异常如何采集?答:window.onerror + error 事件。
- 常见追问:Promise 错误?答:unhandledrejection 事件。
- 常见追问:资源加载错误?答:捕获阶段监听,资源错误不冒泡。
- 常见追问:白屏检测?答:首屏 DOM 节点数检查。
- 常见追问:错误去重?答:message + stack hash,归一化动态值。
- 常见追问:sourcemap 如何上传?答:@sentry/cli 在 CI 上传。
- 常见追问:跨域脚本错误?答:需要 script.crossOrigin + CORS。
- 常见追问:错误上报隐私?答:beforeSend 脱敏,删除 header 与敏感字段。
- 常见追问:Sentry 工作流程?答:劫持错误 → 上报 → sourcemap 还原。
- 常见追问:sourcemap 还原原理?答:压缩位置 → 源码行列号。
- 常见追问:Promise 错误?答:unhandledrejection 事件。