App 「閃退」是使用者流失主因之一。開發階段 Xcode 控制台可見崩潰堆疊,但上線後使用者裝置無法直接查看。建立自動崩潰捕獲、上傳、分析機制,是保障 App 穩定性的必要環節。
在 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 不屬於 NSException | Swift 端統一 do-catch 上報 |
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);
這些 SDK 內建完整的 Mach Exception、Signal、NSException、Swift Error 捕獲、符號化上傳、分組去重、趨勢分析,強烈建議生產環境直接接入。
設定 → 隱私權 → 分析與改進 → 分析資料 找到 .ips 檔Window → Devices and Simulators → View Device Logssymbolicatecrash crash.ips App.dSYM > crash.log(需對應版本的 .dSYM 檔)NSSetUncaughtExceptionHandler 自製簡易版.dSYM 檔案(上傳至符號化服務或本地妥善保管)