Flutter iOS集成Firebase Crashlytics一直显示等待应用问题求助

核心问题 #

已完成Flutter iOS应用的Firebase Crashlytics配置，添加了触发同步异常的按钮，FlutterError.onError已捕获异常并调用recordFlutterError，但Firebase控制台始终显示“等待应用发送崩溃数据”；同时开启了Xcode调试日志但不知查看位置，异步错误处理器未触发。

可能原因及解决步骤 #

1. 调试模式下数据未自动上传

Crashlytics默认不会在Debug构建模式下上传崩溃/错误数据，需手动开启调试收集：

// 在Firebase初始化后添加
await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
// 若要强制调试模式上传，可结合环境判断
// await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(kDebugMode || true);

调试模式下上传存在延迟，建议优先用Release模式测试，或重启应用后等待5-10分钟再查看控制台。

2. iOS原生端配置遗漏

即使Flutter层配置正确，iOS端可能存在未完成的关键步骤：

• 确认ios/Runner/GoogleService-Info.plist已正确导入，且文件中的Bundle ID与Firebase控制台完全一致；
• 检查Xcode的Build Phases是否添加Crashlytics运行脚本：
  1. 打开Xcode项目，进入Runner目标的Build Phases；
  2. 添加Run Script，内容为：

     "${PODS_ROOT}/FirebaseCrashlytics/run"
     

  3. 勾选Run script only when installing（可选，避免编译时重复执行）；
• 在ios/Runner/Info.plist中添加强制收集开关：

  <key>FirebaseCrashlyticsCollectionEnabled</key>
  <true/>
  

3. 数据上传时机未满足

Crashlytics并非实时上传数据，需满足以下条件之一：

• 应用崩溃后重启；
• 手动触发上传（调试时可用）：

  await FirebaseCrashlytics.instance.sendUnsentReports();
  

• 注意：recordFlutterError记录的是非致命错误，需在Firebase控制台的「非致命」标签页查看，而非「致命崩溃」页面。

4. Xcode调试日志查看位置

开启调试日志后，在Xcode中查看Crashlytics相关日志：

1. 连接iOS设备或启动模拟器，运行应用；
2. 打开Xcode的Console面板（菜单路径：View > Debug Area > Activate Console）；
3. 在搜索框输入FirebaseCrashlytics，即可过滤出Crashlytics的初始化、上传、错误捕获日志。

5. 异步错误处理器未触发的原因

当前触发的是同步异常（throw Exception()在同步回调onPressed中），不会进入PlatformDispatcher.instance.onError——该处理器仅捕获：

• 异步任务中未处理的错误（如Future未用catchError捕获）；
• Isolate中的未处理错误；
  若要测试异步错误，可修改触发按钮代码：

TextButton(
  onPressed: () {
    // 模拟未捕获的异步错误
    Future.delayed(const Duration(seconds: 1), () {
      throw Exception("Async unhandled error");
    });
  },
  child: const Text("Trigger Async Error"),
)

6. Firebase项目或SDK兼容性问题

• 确认Firebase控制台中该应用的Crashlytics服务已启用；
• 升级pubspec.yaml中Firebase相关依赖到最新稳定版：

  firebase_core: ^2.15.0
  firebase_crashlytics: ^3.3.0
  

• 若使用VPN或代理，可能导致数据无法上传，关闭代理后重新测试。

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