FirebaseCrashlytics处理未捕获异常时触发TimeoutException，疑与R8代码混淆相关的问题求助

阿华AIGC实验室

2026-4-29

解决R8混淆导致Firebase Crashlytics超时异常的问题

我之前碰到过类似的情况，结合你的描述来看，这个问题的核心是Release构建下R8的激进优化干扰了Crashlytics的异常处理流程——Debug模式即使开启混淆，R8的优化力度也会弱很多，所以不会触发这个超时问题。下面是一步步的排查和解决方法：

1. 补充Crashlytics专属的Proguard/R8规则

R8在Release优化时，可能会把Crashlytics依赖的类、注解或者关键方法误优化掉，导致初始化或异常处理超时。在你的proguard-rules.pro里添加以下规则：

# 保留Crashlytics核心类不被混淆和优化
-keep class com.google.firebase.crashlytics.** { *; }
# 保留注解信息，Crashlytics依赖注解完成初始化和数据收集
-keepattributes *Annotation*
# 保留源文件和行号，方便后续堆栈分析
-keepattributes SourceFile,LineNumberTable
# 保留错误日志中涉及的自定义类（混淆后的类名）
-keep class planner.n63.Utils { *; }
-keep class planner.v00.CrashlyticsController { *; }
-keep class planner.y10.CrashlyticsUncaughtExceptionHandler { *; }

2. 调整Firebase初始化时机

你的App类里在onCreate初始化Firebase，但Release构建下可能因为代码优化，初始化被延迟，导致Crashlytics在处理未捕获异常时还没准备好，触发超时。建议把初始化提前到attachBaseContext：

class App : Application() {
    override fun attachBaseContext(base: Context) {
        super.attachBaseContext(base)
        // 强制同步初始化Firebase
        FirebaseApp.initializeApp(this)
        // 确保Crashlytics收集功能开启
        FirebaseCrashlytics.getInstance().setCrashlyticsCollectionEnabled(true)
    }
}

3. 排查R8优化级别

你当前使用的proguard-android-optimize.txt是带优化的默认规则，R8会做很多激进的代码精简。可以先临时换成proguard-android.txt（无优化）测试，看是否还出现超时：

release {
    proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    minifyEnabled true
}

如果问题消失，说明是某个优化项导致的，可以再逐步开启优化，配合Proguard规则精准排除Crashlytics相关代码的优化。

4. 对齐CI构建的依赖版本

CI环境可能使用了和本地不同的Gradle插件、Crashlytics插件版本，导致R8的行为不一致。建议在项目级build.gradle里锁定版本：

buildscript {
    dependencies {
        // 锁定Gradle插件稳定版本
        classpath 'com.android.tools.build:gradle:7.4.2'
        // 锁定Crashlytics插件稳定版本
        classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.2'
    }
}