沒有任何開發者能保證零 Bug。對於已上線、擁有大量用戶的 App,無法在本地重現所有崩潰場景。自動收集崩潰堆疊、裝置資訊並上傳至伺服器,是保障 App 穩定性、快速定位線上問題的必要基建。
Java 提供 Thread.UncaughtExceptionHandler 介面,當執行緒因未捕獲異常終止時會回呼 uncaughtException(Thread, Throwable)。Android 主執行緒 (UI Thread) 同樣適用。
// 設定全域預設處理器(通常在 Application.onCreate() 中)
Thread.setDefaultUncaughtExceptionHandler(new MyCrashHandler());
public class MyCrashHandler implements Thread.UncaughtExceptionHandler {
private static final String TAG = "CrashHandler";
private final Thread.UncaughtExceptionHandler defaultHandler;
private final Context context;
public MyCrashHandler(Context context) {
this.context = context.getApplicationContext();
this.defaultHandler = Thread.getDefaultUncaughtExceptionHandler();
}
@Override
public void uncaughtException(Thread thread, Throwable ex) {
// 1. 收集完整堆疊資訊
StringWriter sw = new StringWriter();
PrintWriter pw = new PrintWriter(sw);
ex.printStackTrace(pw);
pw.close();
String stackTrace = sw.toString();
// 2. 附加裝置關鍵資訊(型號、系統版本、指紋、App 版本等)
String deviceInfo = String.format(Locale.US,
"Device: %s\nOS: %s\nAPI: %d\nFingerprint: %s\nAppVersion: %s\n",
Build.MODEL, Build.VERSION.RELEASE, Build.VERSION.SDK_INT,
Build.FINGERPRINT, BuildConfig.VERSION_NAME);
String fullReport = deviceInfo + "\n" + stackTrace;
Log.e(TAG, fullReport);
// 3. 本地持久化(SD 卡或內部儲存)
saveToLocal(fullReport);
// 4. 非同步上傳至伺服器
uploadToServer(fullReport);
// 5. 最後交給系統預設處理器(顯示「應用程式停止運作」對話框、殺掉進程)
if (defaultHandler != null) {
defaultHandler.uncaughtException(thread, ex);
} else {
Process.killProcess(Process.myPid());
System.exit(10);
}
}
private void saveToLocal(String report) {
File dir = new File(context.getExternalFilesDir(null), "crash_logs");
if (!dir.exists()) dir.mkdirs();
File file = new File(dir, "crash_" + System.currentTimeMillis() + ".log");
try (FileOutputStream fos = new FileOutputStream(file);
OutputStreamWriter osw = new OutputStreamWriter(fos, StandardCharsets.UTF_8);
BufferedWriter bw = new BufferedWriter(osw)) {
bw.write(report);
} catch (IOException e) {
Log.e(TAG, "Save crash log failed", e);
}
}
private void uploadToServer(String report) {
// 生產環境建議使用 OkHttp + 指數退避重試,或整合成熟 SDK (Firebase Crashlytics, Sentry, Bugly 等)
new Thread(() -> {
try {
OkHttpClient client = new OkHttpClient();
RequestBody body = new FormBody.Builder()
.add("report", report)
.add("package", context.getPackageName())
.build();
Request request = new Request.Builder()
.url("https://your-api.example.com/crash/upload")
.post(body)
.build();
client.newCall(request).execute();
} catch (Exception e) {
Log.e(TAG, "Upload crash log failed", e);
}
}).start();
}
}
| 面向 | 建議 |
|---|---|
| 初始化時機 | 在 Application.onCreate() 最早期初始化,確保覆蓋所有執行緒。 |
| ANR 處理 | UncaughtExceptionHandler 無法捕獲 ANR (Application Not Responding);需另行實作 Watchdog 或使用支援 ANR 的 SDK。 |
| 原生崩潰 (NDK) | Java 層無法捕獲 C/C++ 崩潰;需整合 Breakpad 或使用 Firebase Crashlytics 等支援 NDK 的方案。 |
| 隱私合規 | 堆疊可能包含用戶資料(如路徑、輸入內容);上傳前需脫敏,並遵循 GDPR/個資法告知用戶。 |
| 去重與聚合 | 伺服器端需按堆疊特徵去重、聚合統計,避免同一 Bug 產生大量重複工單。 |
| 網路失敗重試 | 採用指數退避 + 本地佇列持久化,確保最終送達。 |
自建方案維護成本高、易遺漏邊界案例。強烈建議接入業界標準方案:
若因合規必須自建,參考本文核心邏輯,並務必補齊 NDK、ANR、去重、合規、高可用上傳通道等模組。
實作 UncaughtExceptionHandler 並配合本地落盤 + 非同步上傳,是 App 崩潰收集的基礎骨架。理解其原理有助於排查 SDK 底層行為,但生產環境請優先選擇成熟的商業/開源 SDK,將精力集中在業務迭代與穩定性治理上。