Flutter集成Firebase Crashlytics时如何反混淆Java堆栈跟踪

Firebase控制台观测到的崩溃日志如下：

Fatal Exception: io.flutter.plugins.firebase.crashlytics.FlutterError: Bad state: Cannot add event after closing. Error thrown null.
       at _StreamController.add(_StreamController.java:595)
       at _Rb.add(_Rb.java:867)
       at ._Zj(.java:1434)
       at _Fc.runUnary(_Fc.java:1335)
       at _Fc.fRa(_Fc.java:1244)
       at _BufferingStreamSubscription._ieb(_BufferingStreamSubscription.java:341)
       at _BufferingStreamSubscription._add(_BufferingStreamSubscription.java:271)
       at _hc._add(_hc.java:123)
       at _kc._Veb(_kc.java:253)
       at _hc._Veb(_hc.java:153)
       at ._Zj(.java:1434)
       at _Fc.runUnary(_Fc.java:1335)
       at _Fc.fRa(_Fc.java:1244)
       at _BufferingStreamSubscription._ieb(_BufferingStreamSubscription.java:341)
       at _BufferingStreamSubscription._add(_BufferingStreamSubscription.java:271)
       at _hc._add(_hc.java:123)
       at _jc._Veb(_jc.java:218)
       at _hc._Veb(_hc.java:153)
       at ._Zj(.java:1434)
       at _Fc.runUnary(_Fc.java:1335)
       at _Fc.fRa(_Fc.java:1244)
       at _BufferingStreamSubscription._ieb(_BufferingStreamSubscription.java:341)
       at _BufferingStreamSubscription._add(_BufferingStreamSubscription.java:271)
       at _hc._add(_hc.java:123)
       at _jc._Veb(_jc.java:218)
       at _hc._Veb(_hc.java:153)
       at ._Zj(.java:1434)
       at _Fc.runUnary(_Fc.java:1335)
       at _Fc.fRa(_Fc.java:1244)
       at _BufferingStreamSubscription._ieb(_BufferingStreamSubscription.java:341)
       at _Yb.zdb(_Yb.java:591)
       at _bc.pdb(_bc.java:706)
       at _Wb.tdb.<fn>(tdb.java:663)
       at ._Wj(.java:1418)
       at _Fc.oRa(_Fc.java:1328)
       at _Fc.eRa(_Fc.java:1236)
       at _Fc.jRa.<fn>(jRa.java:1276)
       at ._Wj(.java:1426)
       at _Fc.oRa(_Fc.java:1328)
       at _Fc.eRa(_Fc.java:1236)
       at _Fc.jRa.<fn>(jRa.java:1276)
       at ._yj(.java:40)
       at ._zj(.java:49)

当前pubspec.lock中提取的Firebase相关依赖版本：

firebase_crashlytics:
    dependency: "direct main"
    description:
      name: firebase_crashlytics
      url: "https://pub.dartlang.org"
    source: hosted
    version: "2.8.2"
  firebase_crashlytics_platform_interface:
    dependency: transitive
    description:
      name: firebase_crashlytics_platform_interface
      url: "https://pub.dartlang.org"
    source: hosted
    version: "3.2.8"

已完成的Android release构建混淆配置：

release {
    signingConfig signingConfigs.googleplaySigningConfig

    minifyEnabled true
    debuggable false
    proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard.cfg'

    firebaseCrashlytics {
        mappingFileUploadEnabled true
        nativeSymbolUploadEnabled true
        unstrippedNativeLibsDir "build/app/intermediates/merged_native_libs/release/out/lib"
    }

    ndk {
        debugSymbolLevel 'FULL'
    }
}

核心疑问：

• 崩溃属于Dart代码层，但堆栈中出现.java文件相关条目，无法定位问题
• 已配置Android混淆规则和mapping文件上传，仍无法获取可读堆栈

堆栈中显示的.java后缀混淆类名不是Java代码，是Flutter release模式下Dart AOT编译生成的混淆后快照符号。当前使用的firebase_crashlytics 2.8.2版本对Dart侧符号上传支持存在缺陷，没有自动处理Dart混淆符号的上传逻辑，Crashlytics后台拿不到Dart符号表，就无法把混淆后的符号还原为业务代码的类名、方法名和行号，才会显示为类似Java类名的乱码符号。
当前配置的mappingFileUploadEnabled和NDK符号上传规则，仅能还原Android原生Java/Kotlin、C/C++层的堆栈，对Dart层堆栈无效。

• 升级firebase_crashlytics到3.x以上稳定版本，2.x版本未内置完整的Dart符号上传支持，存在兼容缺陷。
• 打包Flutter release包时必须使用Flutter官方构建命令，不要直接通过Android Studio的Android模块入口打包：执行flutter build appbundle --obfuscate --split-debug-info=build/debug-info，其中--obfuscate开启Dart代码混淆，--split-debug-info指定的目录会自动生成Dart侧符号表文件。
• 打包完成后执行Dart符号上传命令：flutterfire upload-crashlytics-symbols --debug-info-path=build/debug-info --platform=android，将生成的Dart符号表上传到Firebase后台，Crashlytics会自动关联符号表用于堆栈反混淆。
• 检查Android模块build.gradle配置，确认已正确应用Crashlytics Gradle插件，插件版本与项目使用的Firebase BOM版本保持一致，避免因插件版本过旧导致mapping文件上传失败。
• 重新构建正式包上传到测试渠道，复现相同崩溃后等待15-30分钟，再进入Firebase控制台查看，堆栈会自动反混淆为对应Dart业务代码的类名、方法名和行号。

堆栈中抛出的Bad state: Cannot add event after closing是Dart Stream的典型错误，含义是StreamController调用close()方法后，仍有逻辑在向该Stream执行add操作。堆栈还原后直接排查对应业务代码的Stream使用逻辑，检查Stream关闭后是否存在未取消的异步回调触发add事件，即可定位问题根因。

内容的提问来源于stack exchange，提问作者4ntoine