萬盛學電腦網

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

Android App 崩潰日誌自動收集與上傳:從 UncaughtExceptionHandler 到生產級方案

為什麼需要崩潰收集?

沒有任何開發者能保證零 Bug。對於已上線、擁有大量用戶的 App,無法在本地重現所有崩潰場景。自動收集崩潰堆疊、裝置資訊並上傳至伺服器,是保障 App 穩定性、快速定位線上問題的必要基建。

核心機制:Thread.UncaughtExceptionHandler

Java 提供 Thread.UncaughtExceptionHandler 介面,當執行緒因未捕獲異常終止時會回呼 uncaughtException(Thread, Throwable)。Android 主執行緒 (UI Thread) 同樣適用。

// 設定全域預設處理器(通常在 Application.onCreate() 中)
Thread.setDefaultUncaughtExceptionHandler(new MyCrashHandler());

自訂 CrashHandler 實作詳解

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 產生大量重複工單。
網路失敗重試採用指數退避 + 本地佇列持久化,確保最終送達。

生產級建議:直接整合成熟 SDK

自建方案維護成本高、易遺漏邊界案例。強烈建議接入業界標準方案:

  • Firebase Crashlytics:免費、自動收集 Java/Kotlin/NDK/ANR、豐富儀表板、Gradle 整合極簡。
  • Sentry:開源、支援自架、多語言、效能監控整合。
  • Bugly (騰訊):國內訪問快、支援熱修復、符合國內合規。

若因合規必須自建,參考本文核心邏輯,並務必補齊 NDK、ANR、去重、合規、高可用上傳通道等模組。

總結

實作 UncaughtExceptionHandler 並配合本地落盤 + 非同步上傳,是 App 崩潰收集的基礎骨架。理解其原理有助於排查 SDK 底層行為,但生產環境請優先選擇成熟的商業/開源 SDK,將精力集中在業務迭代與穩定性治理上。

copyright © 萬盛學電腦網 all rights reserved