此頁面提供故障排除幫助以及有關使用 Crashlytics 的常見問題解答。如果您找不到所需內容或需要其他幫助,請聯繫Firebase 支持。
一般故障排除/常見問題解答
如果您沒有看到無崩潰的用戶、麵包屑日誌和/或速度警報,我們建議您檢查您的應用程序的 Google Analytics 配置。
確保您已在 Firebase 項目中啟用 Google Analytics 。
確保在 Firebase 控制台的集成> Google Analytics頁面中為 Google Analytics 啟用了數據共享。請注意,數據共享設置顯示在 Firebase 控制台中,但在 Google Analytics(分析)控制台中進行管理。
除了 Firebase Crashlytics SDK,請確保您已將 Firebase SDK for Google Analytics 添加到您的應用 ( iOS+ | Android )。
確保您為所有 Firebase SDK ( iOS+ | Android ) 使用最新版本。
尤其要檢查您是否至少使用了以下版本的 Firebase SDK for Google Analytics: iOS+ — v6.3.1+(v8.9.0+ 用於 macOS 和 tvOS)| Android — v17.2.3+(BoM v24.7.1+) 。
Crashlytics 支持對來自運行 Android 11 及更高版本的設備的 Android 應用程序進行 ANR 報告。我們用來收集 ANR 的底層 API ( getHistoricalProcessExitReasons ) 比 SIGQUIT 或基於看門狗的方法更可靠。此 API 僅適用於 Android 11+ 設備。
Google Play 和 Crashlytics 之間的 ANR 計數可能不匹配。這是預期的,因為收集和報告 ANR 數據的機制不同。 Crashlytics 會在應用下次啟動時報告 ANR,而 Android Vitals 會在 ANR 發生後發送 ANR 數據。
此外,Crashlytics 僅顯示在運行 Android 11+ 的設備上發生的 ANR,而 Google Play 則顯示來自接受了 Google Play 服務和數據收集同意的設備的 ANR。
LLVM 和 GNU 工具鏈對應用二進製文件的只讀段有不同的默認值和處理方式,這可能會在 Firebase 控制台中生成不一致的堆棧跟踪。為了緩解這種情況,請將以下鏈接器標誌添加到您的構建過程中:
如果您使用 LLVM 工具鏈中的
lld
鏈接器,請添加:-Wl,--no-rosegment
如果您使用 GNU 工具鏈中的
ld.gold
鏈接器,請添加:-Wl,--rosegment
如果您仍然看到堆棧跟踪不一致(或者如果兩個標誌都與您的工具鏈無關),請嘗試將以下內容添加到您的構建過程中:
-fno-omit-frame-pointer
Crashlytics 插件捆綁了一個定制的 Breakpad 符號文件生成器。如果您喜歡使用自己的二進製文件來生成 Breakpad 符號文件(例如,如果您喜歡從源代碼構建構建鏈中的所有本機可執行文件),請使用可選的symbolGeneratorBinary
擴展屬性來指定可執行文件的路徑。
您可以通過以下兩種方式之一指定 Breakpad 符號文件生成器二進製文件的路徑:
選項 1 :通過
build.gradle
文件中的firebaseCrashlytics
擴展指定路徑將以下內容添加到您的應用級
build.gradle
文件中:android { // ... buildTypes { // ... release { // ... firebaseCrashlytics { // existing; required for either symbol file generator nativeSymbolUploadEnabled true // Add this optional new block to specify the path to the executable symbolGenerator { breakpad { binary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } } }
選項 2 :通過 Gradle 屬性文件中的屬性行指定路徑
您可以使用
com.google.firebase.crashlytics.symbolGeneratorBinary
屬性來指定可執行文件的路徑。您可以手動更新 Gradle 屬性文件或通過命令行更新文件。例如,要通過命令行指定路徑,請使用如下命令:
./gradlew -Pcom.google.firebase.crashlytics.symbolGenerator=breakpad \ -Pcom.google.firebase.crashlytics.symbolGeneratorBinary=/PATH/TO/BREAKPAD/DUMP_SYMS \ app:assembleRelease app:uploadCrashlyticsSymbolFileRelease
如果您看到以下異常,很可能您使用的 DexGuard 版本與 Firebase Crashlytics SDK 不兼容:
java.lang.IllegalArgumentException: Transport backend 'cct' is not registered
此異常不會使您的應用程序崩潰,但會阻止它發送崩潰報告。要解決這個問題:
確保您使用的是最新的 DexGuard 8.x 版本。最新版本包含 Firebase Crashlytics SDK 所需的規則。
如果您不想更改您的 DexGuard 版本,請嘗試將以下行添加到您的混淆規則(在您的 DexGuard 配置文件中):
-keepresourcexmlelements manifest/application/service/meta-data@value=cct
當應用程序使用不公開文件擴展名的混淆器時,默認情況下,Crashlytics 會生成每個帶有.java
文件擴展名的問題。
為了使 Crashlytics 可以使用正確的文件擴展名生成問題,請確保您的應用使用以下設置:
- 使用 Android Gradle 4.2.0 或更高版本
- 使用打開了混淆的 R8。要將您的應用程序更新到 R8,請遵循此文檔。
請注意,更新到上述設置後,您可能會開始看到與現有.java
問題重複的新.kt
問題。請參閱常見問題解答以了解有關該情況的更多信息。
從 2021 年 12 月中旬開始,Crashlytics 改進了對使用 Kotlin 的應用程序的支持。
直到最近,可用的混淆器還沒有公開文件擴展名,因此 Crashlytics 生成的每個問題默認使用.java
文件擴展名。但是,從 Android Gradle 4.2.0 開始,R8 支持文件擴展名。
通過這次更新,Crashlytics 現在可以確定應用程序中使用的每個類是否都是用 Kotlin 編寫的,並在問題簽名中包含正確的文件名。如果您的應用具有以下設置,則崩潰現在可以正確歸因於.kt
文件(視情況而定):
- 您的應用使用 Android Gradle 4.2.0 或更高版本。
- 您的應用使用 R8 並啟用了混淆功能。
由於新的崩潰現在在其問題簽名中包含正確的文件擴展名,您可能會看到新的.kt
問題實際上只是現有.java
標記的問題的副本。在 Firebase 控制台中,如果新的.kt
問題可能與現有.java
標記的問題重複,我們會嘗試識別並與您溝通。
無崩潰值表示與您的應用互動但在特定時間段內未發生崩潰的用戶百分比。
這是計算無崩潰用戶百分比的公式。其輸入值由 Google Analytics 提供。
1 - ( CRASHED_USERS / ALL_USERS )
當發生崩潰時,Google Analytics 會發送一個
app_exception
事件類型, CRASHED_USERS表示與該事件類型關聯的用戶數。ALL_USERS表示在您從 Crashlytics 儀表板右上角的下拉菜單中選擇的時間段內與您的應用互動的用戶總數。
您可以在 Analytics 儀表板中查看應用程序的app_exception
事件數。請注意,由於崩潰處理方式的細微差別,分析儀表板中顯示的app_exception
數字有時可能與無崩潰用戶計算中使用的數字不同。
無崩潰用戶百分比是一段時間內的聚合,而不是平均值。
例如,假設您的應用程序有三個用戶;我們稱他們為用戶 A、用戶 B 和用戶 C。下表顯示了每天與您的應用互動的用戶以及當天發生崩潰的用戶:
週一 | 週二 | 週三 | |
---|---|---|---|
與您的應用互動的用戶 | 甲、乙、丙 | 甲、乙、丙 | 甲,乙 |
發生崩潰的用戶 | C | 乙 | 一個 |
週三,您的無崩潰用戶百分比為 50%(每 2 位用戶中就有 1 位沒有崩潰)。
您的兩位用戶在周三使用了您的應用,但其中只有一位(用戶 B)沒有崩潰。在過去 2 天中,您的無崩潰用戶百分比為 33.3%(三分之一的用戶無崩潰)。
在過去兩天中,您的三位用戶與您的應用進行了互動,但其中只有一位(用戶 C)沒有崩潰。在過去 3 天中,您的無崩潰用戶百分比為 0%(3 名用戶中有 0 名無崩潰)。
您的三位用戶在過去三天內與您的應用進行了互動,但其中零位沒有發生崩潰。
集成
如果您的項目將 Crashlytics 與 Google 移動廣告 SDK 一起使用,則崩潰報告器可能會在註冊異常處理程序時進行干擾。要解決此問題,請通過調用disableSDKCrashReporting
關閉移動廣告 SDK 中的崩潰報告。
將 Crashlytics 鏈接到 BigQuery 後,無論您的 Firebase 項目位於何處,您創建的新數據集都會自動位於美國。
平台支持
Firebase Crashlytics NDK 不支持 ARMv5 (armeabi)。自 NDK r17 起,已刪除對此 ABI 的支持。
回歸問題
當您之前關閉問題時,問題已經回歸,但 Crashlytics 會收到一份新報告,表明該問題再次發生。 Crashlytics 會自動重新打開這些回歸問題,以便您可以根據自己的應用程序解決這些問題。
下面是一個示例場景,它解釋了 Crashlytics 如何將問題歸類為回歸:
- Crashlytics 有史以來第一次收到有關 Crash "A" 的崩潰報告。 Crashlytics 為該崩潰打開了相應的問題(問題“A”)。
- 您快速修復此錯誤,關閉問題“A”,然後發布您的應用程序的新版本。
- 在您關閉問題後,Crashlytics 會收到關於問題“A”的另一份報告。
- 如果報告來自 Crashlytics 在您關閉問題時知道的應用程序版本(意味著該版本已發送任何崩潰的崩潰報告),則 Crashlytics 不會認為該問題已回歸。該問題將保持關閉。
- 如果報告來自您關閉問題時 Crashlytics不知道的應用程序版本(意味著該版本根本沒有針對任何崩潰發送任何崩潰報告),則 Crashlytics 會認為該問題已退化,並將重新打開該問題.
當問題回歸時,我們會發送回歸檢測警報並向問題添加回歸信號,讓您知道 Crashlytics 已重新打開該問題。如果您不希望由於我們的回歸算法而重新打開某個問題,請“靜音”該問題而不是關閉它。
如果報告來自在您關閉問題時從未發送過任何崩潰報告的舊應用程序版本,則 Crashlytics 會認為該問題已退化,並將重新打開該問題。
這種情況可能發生在以下情況:您已經修復了一個錯誤並發布了應用程序的新版本,但您仍然有用戶使用舊版本而沒有修復錯誤。如果偶然地,當您關閉問題時,其中一個舊版本根本沒有發送任何崩潰報告,並且這些用戶開始遇到錯誤,那麼這些崩潰報告將觸發回歸問題。
如果您不希望由於我們的回歸算法而重新打開某個問題,請“靜音”該問題而不是關閉它。