罗罗编程学习记录
本页内容 展开查看

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。

原理流程

  1. SDK 初始化 DSN。
  2. 劫持错误事件。
  3. 上报到 Sentry。
  4. 服务端用 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 文件。
  • 映射:压缩位置 → 源码位置。

原理流程

  1. 构建生成 .map。
  2. 上传 Sentry。
  3. 错误上报带压缩位置。
  4. 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 对象。

原理流程

  1. 监听 error。
  2. 收集堆栈。
  3. 上报。

代码 / 示例

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:错误原因。

原理流程

  1. 监听 unhandledrejection。
  2. 收集 reason。
  3. 上报。

代码 / 示例

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) 捕获。

概念解释

  • 资源错误:不冒泡。
  • 捕获阶段:捕获资源错误。

原理流程

  1. document 上监听 error,capture true。
  2. 判断 target 是元素。
  3. 上报 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 是否有子节点。

原理流程

  1. 页面加载后定时检查 DOM。
  2. 如果 #root 无子节点或节点数少,上报。
  3. 结合用户会话与性能数据。

代码 / 示例

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 单个。

原理流程

  1. 错误 hash 相同则聚合。
  2. 统计影响用户数。
  3. 超阈值告警。

代码 / 示例

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:个人身份信息。

原理流程

  1. Sentry 配置 scrub 默认 header。
  2. 自定义 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 文件发到监控平台。

原理流程

  1. CI 构建生成 dist + .map。
  2. sentry-cli 上传 .map 到 Sentry。
  3. 生产环境只部署 dist,不部署 .map。
  4. 错误上报时带 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 事件。