萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> iOS 開發

iOS App 崩潰日誌捕獲與分析完整指南

前言:為什麼需要崩潰收集機制?

App 「閃退」是使用者流失主因之一。開發階段 Xcode 控制台可見崩潰堆疊,但上線後使用者裝置無法直接查看。建立自動崩潰捕獲、上傳、分析機制,是保障 App 穩定性的必要環節。

核心方案:NSSetUncaughtExceptionHandler

在 App 啟動早期(application:didFinishLaunchingWithOptions:)註冊全域例外處理器:

// AppDelegate.m
#import <UIKit/UIKit.h>

void UncaughtExceptionHandler(NSException *exception) {
    // 1. 取得呼叫堆疊
    NSArray *callStack = [exception callStackSymbols];
    
    // 2. 取得崩潰原因(最關鍵資訊)
    NSString *reason = [exception reason];
    
    // 3. 取得異常類型
    NSString *name = [exception name];
    
    // 4. 組裝完整崩潰報告
    NSString *report = [NSString stringWithFormat:
        @"Exception Type: %@\nCrash Reason: %@\nCall Stack:\n%@",
        name, reason, [callStack componentsJoinedByString:@"\n"]
    ];
    
    // 5. 本地持久化(關鍵:下次啟動上傳)
    [[NSUserDefaults standardUserDefaults] setObject:report forKey:@"LastCrashReport"];
    [[NSUserDefaults standardUserDefaults] synchronize];
    
    // 6. 可選:同步寫入檔案(更可靠)
    NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject
                      stringByAppendingPathComponent:@"crash_log.txt"];
    [report writeToFile:path atomically:YES encoding:NSUTF8StringEncoding error:nil];
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 註冊全域例外處理器
    NSSetUncaughtExceptionHandler(&UncaughtExceptionHandler);
    
    // 檢查是否有上次崩潰記錄,上傳至伺服器
    NSString *lastCrash = [[NSUserDefaults standardUserDefaults] objectForKey:@"LastCrashReport"];
    if (lastCrash) {
        [self uploadCrashReport:lastCrash];
        [[NSUserDefaults standardUserDefaults] removeObjectForKey:@"LastCrashReport"];
    }
    
    return YES;
}

方案局限與補強

局限說明補強方案
僅捕獲 Objective-C 例外C/C++ 標準庫錯誤、訊號(SIGSEGV、SIGABRT)不會觸發搭配 signal() 註冊訊號處理器
主執行緒阻塞風險處理器內執行耗時操作可能導致 Watchdog 殺掉進程僅做極輕量持久化,上傳延遲到下次啟動
記憶體不足崩潰無法捕獲系統直接殺進程,無回調機會依賴系統生成的 .ips 分析檔
Swift Error 不會觸發Swift 的 throw 不屬於 NSExceptionSwift 端統一 do-catch 上報

訊號處理器補充(捕獲 C 層崩潰)


void SignalHandler(int signal) {
    // 只能呼叫 async-signal-safe 函數
    // 這裡僅做極簡單記錄,避免死鎖
    const char *msg = "Caught signal: ";
    write(STDERR_FILENO, msg, strlen(msg));
    char sigStr[4];
    snprintf(sigStr, sizeof(sigStr), "%d\n", signal);
    write(STDERR_FILENO, sigStr, strlen(sigStr));
    
    // 重新註冊預設處理器並觸發,產生系統 .ips 檔
    signal(signal, SIG_DFL);
    raise(signal);
}

// 在 didFinishLaunching 中註冊
signal(SIGSEGV, SignalHandler);
signal(SIGABRT, SignalHandler);
signal(SIGBUS, SignalHandler);
signal(SIGILL, SignalHandler);
signal(SIGFPE, SignalHandler);
signal(SIGPIPE, SignalHandler);

第三方成熟方案推薦(生產環境首選)

  • Firebase Crashlytics:免費、即時、符號化自動、介面優秀
  • Sentry:開源可自建、支援多平台、效能監控整合
  • Bugly (騰訊):國內訪問快、微信小程式支援、免費額度大
  • Umeng+ (友盟):國內老牌、統計分析整合

這些 SDK 內建完整的 Mach Exception、Signal、NSException、Swift Error 捕獲、符號化上傳、分組去重、趨勢分析,強烈建議生產環境直接接入。

系統 .ips 檔案獲取與符號化

  1. 使用者裝置:設定 → 隱私權 → 分析與改進 → 分析資料 找到 .ips 檔
  2. 開發者裝置:Xcode → Window → Devices and Simulators → View Device Logs
  3. 符號化:symbolicatecrash crash.ips App.dSYM > crash.log(需對應版本的 .dSYM 檔)

總結建議

  1. 開發/測試階段:Xcode 控制台 + 斷點 + NSSetUncaughtExceptionHandler 自製簡易版
  2. 測試/預發環境:接入 Crashlytics/Sentry 內測版
  3. 正式環境:必接成熟第三方 SDK,自建僅作補充
  4. 保留所有版本的 .dSYM 檔案(上傳至符號化服務或本地妥善保管)
  5. 建立崩潰率監控告警(如 > 1% 即時通知)
copyright © 萬盛學電腦網 all rights reserved