萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

前端異常捕獲與分析實戰:從 try-catch 到 window.onerror 全鏈路方案

隨著單頁應用(SPA)普及,前端異常捕獲已成保障用戶體驗的必修課。本文系統梳理異常捕獲方式、信息收集策略、跨域腳本限制繞過方案,構建完整前端監控體系。

一、異常捕獲兩大路徑

1. 已知風險點:try-catch 主動防禦

適用於明確可能拋錯的 API 調用、第三方回調執行:

// localStorage 寫入超額/隱私模式拋錯
try {
    localStorage.setItem('date', Date.now());
} catch (error) {
    reportError(error);
}

// 回調執行隔離:防止單個回調錯誤阻塞後續邏輯
listeners.forEach(function(listener) {
    try {
        listener();
    } catch (error) {
        reportError(error);
    }
});

2. 未知/全局異常:window.onerror 兜底

window.onerror = function(errorMessage, scriptURI, lineNumber, columnNumber, error) {
    if (error) {
        // 現代瀏覽器提供完整 Error 對象(第5參數)
        reportError(error);
    } else {
        // 舊瀏覽器只有前3參數
        reportError({
            message: errorMessage,
            script: scriptURI,
            line: lineNumber,
            column: columnNumber
        });
    }
};

關鍵點:

  • 只用 window.onerror,勿用 addEventListener('error')(標準草案定義的是 onerror)
  • 第 5 參數 error 為完整 Error 對象(Chrome 30+、Firefox、Edge 支持),包含堆棧、自定義屬性

二、關鍵信息收集與正規化

1. 核心屬性清單

  • name:錯誤類型(TypeError、ReferenceError 等)
  • message:錯誤描述
  • script/filename:腳本 URL
  • line/lineno、column/colno:行列號
  • stack:堆棧跟蹤字符串

2. 跨瀏覽器屬性名映射(正規化)

function normalizeError(err) {
    return {
        name: err.name,
        message: err.message,
        script: err.script || err.filename || err.sourceURL,
        line: err.line || err.lineno,
        column: err.column || err.colno,
        stack: err.stack
    };
}

需維護瀏覽器差異映射表,定期更新。

3. 堆棧解析

各瀏覽器 stack 格式不同,需編寫正則提取每幀:

  • 函數名(identifier)
  • 文件(script)
  • 行號、列號

可參考 stacktrace.js 等成熟庫。

三、序列化傳遞:繞過屬性丟失

window.onerror 早期僅 3 參數,屬性易丟失。技巧:自定義 Error 時將關鍵信息 JSON.stringify 進 message:

throw new Error(JSON.stringify({
    type: 'API_ERROR',
    code: 4001,
    detail: { url: '/api/user', params: {id: 1} }
}));

// onerror 中反序列化
window.onerror = function(msg, ...args) {
    try {
        var parsed = JSON.parse(msg);
        if (parsed.type) reportError(parsed);
    } catch (e) {
        // 非結構化錯誤,走常規上報
    }
};

僅限主動拋出的 Error 生效。

四、跨域腳本「Script error.」難題與 CORS 解法

1. 現象

CDN 腳本拋錯時,onerror 只收到 "Script error.",無堆棧、無行號。瀏覽器同源策略過濾了異源腳本詳情。

2. CORS 方案:腳文本下載 + 內聯注入

// 原始加載順序需保證
// 
// 
// 

// 改造為調度器模式
function scheduleRemoteScript(url) { /* 下載 -> 內聯 script 標籤注入 */ }
function scheduleInlineScript(fn) { /* 存入隊列,等待依賴就緒後執行 */ }

// 頁面寫法
<script> scheduleRemoteScript('https://cdn.com/step1.js'); </script>
<script> scheduleInlineScript(function code() { step2(); }); </script>
<script> scheduleRemoteScript('https://cdn.com/step3.js'); </script>

實現要點:

  1. 腳本保持在 CDN,利用 XMLHttpRequest + CORS 獲取內容
  2. 構建調度器保證執行順序(依賴圖拓撲排序)
  3. 內聯腳本包裝為函數容器,延遲執行
  4. 注入的 <script> 為同源,錯誤信息完整保留

3. 替代方案對比

方案 優點 缺點
CORS + 內聯注入 完整錯誤信息、保持 CDN 加速 需改造構建流程、調度器複雜
腳本同源部署 零改造 失去 CDN 加速、增加源站壓力
crossorigin="anonymous" + CORS 響應頭 標準化、瀏覽器原生支持 需 CDN 配置 CORS 頭、舊瀏覽器不支持

推薦:現代項目優先使用 <script crossorigin="anonymous"> + 服務端配置 Access-Control-Allow-Origin: *,簡單標準。

五、工程化落地清單

  1. 接入成熟監控 SDK(Sentry、Fundebug、BadJS、ARMS)而非自建
  2. Source Map 自動上傳與解析,還原壓縮代碼行號
  3. 錯誤去重、頻率限制、用戶維度聚合
  4. 關聯用戶行為軌跡(埋點)、Vue/React 組件堆棧
  5. 告警規則:新錯誤、高頻錯誤、核心頁面錯誤率超閾值

結語

前端異常捕獲已從「有無」進入「精準定位、快速復現、關聯業務」的深水區。掌握 try-catch、window.onerror、unhandledrejection 三層防線,配合 Source Map、CORS、調度器等工程化手段,構建可觀測的前端質量體系。

copyright © 萬盛學電腦網 all rights reserved