企业级前端排错是环环相扣的闭环：错误捕全、日志带上下文、断点聚焦高价值场景、复现还原真实环境。关键在守住所涉环节的上下文完整性与信息可追溯性，而非依赖工具堆砌或运气。
企业级前端排错不是靠“刷新重试”或“本地能跑就行”，而是一套环环相扣的闭环：错误得捕得住、日志得传得全、定位得够准、复现得出来、修复得稳当。关键不在工具多炫，而在每个环节不丢上下文、不跳步骤、不依赖运气。
一、错误必须捕全：四类异常一个都不能漏
生产环境里，用户遇到的崩溃往往来自最“安静”的错误——没被 try/catch 包裹的 Promise reject、资源加载失败、语法错误（尤其动态 import）、还有接口返回的业务异常。只监听 window.onerror 是远远不够的。
-
运行时错误：用
window.onerror捕获同步脚本错误，注意它无法拿到 Promise 错误； -
异步错误：必须监听
unhandledrejection，并主动在catch或.then(null, handler)中处理已知 reject； -
资源加载失败：监听
error事件（如<script>、<img>、import()），特别关注ChunkLoadError这类分包加载失败； -
接口异常：在请求拦截层（Axios interceptor / Fetch wrapper）统一识别 HTTP 状态码、网络超时、响应体结构异常（如
code !== 0），并打标为 “api-error” 上报。
二、日志必须带上下文：5个字段决定排查效率
一条没时间戳、没模块名、没 traceId、没用户标识、没堆栈的错误日志，等于没日志。线上问题里，80% 的无效排查都源于日志信息残缺。
-
时间戳：用
new Date().toISOString()，避免本地时区偏差； -
唯一追踪 ID：每个用户会话生成
sessionId，每次请求/操作带上traceId，便于串联前后端日志； -
环境快照：上报时附带
browser.name/version、device.type、network.effectiveType（如 2g/3g/4g）、isWebView； -
错误上下文：不只是
error.stack，还要记录触发前的操作路径（如 “点击支付按钮 → 调用 createOrder → fetch 失败”）、关键变量值（脱敏后）、路由 path； -
分级上报：
error级强制上报，warn级按采样率（如 10%）上报，info/debug级仅开发环境启用。
三、浏览器断点不是乱加：聚焦三类高价值场景
盲目在 Sources 面板里点满断点，只会掩盖真正的问题。高效断点要服务于“确认执行路径”和“验证假设”，而非代替日志。
立即学习“前端免费学习笔记（深入）”；
-
复现偶发白屏：在
document.addEventListener('DOMContentLoaded')和window.addEventListener('load')后加 debugger，观察 DOM 是否构建完成、关键 script 是否加载成功； -
排查状态不一致：在 Vue 的
watch、React 的useEffect或 Redux 的store.subscribe回调中下断点，看状态变更是否如期触发、payload 是否符合预期； -
验证错误拦截逻辑：在全局错误处理器（如
Vue.config.errorHandler或componentDidCatch）第一行加 debugger，确保错误真被接住，而不是被上层吞掉或重复上报。
四、复盘必须还原现场：弱网、旧浏览器、内网环境不能只靠猜
“本地复现不了”不是终点，是起点。企业级排错要求你把用户环境“搬”到本地来验证。
- 网络模拟：Chrome DevTools 的 Network 面板开启 “Slow 3G” 或自定义延迟/丢包，测试 chunk 加载、接口超时、重试逻辑；
- 浏览器降级：用 BrowserStack 或 LambdaTest 测试 Chrome 75、Firefox ESR、国产双核浏览器等低版本行为；
- 内网穿透：若客户在银行/政府内网，用代理工具（如 Charles + Map Local）模拟 CDN 域名被拦截、HTTPS 证书不信任等策略限制；
- 缓存干扰：禁用缓存（Disable cache）、清空 Service Worker、绕过预加载，排除资源版本错配导致的 JS 执行中断。
一套真正落地的企业级排错链路，不靠堆工具，而靠每个环节守住信息完整性——从错误发生那一刻起，上下文就不该丢失；从日志上报那一秒开始，线索就必须可追溯；从你在 DevTools 里按下 F8 的那一瞬，目标就该清晰明确。
