Flutter应用iOS设备上Firebase Crashlytics初始化失败求助

问题现象 #

启动应用时触发以下错误，导致iOS设备崩溃报告无法上传至Crashlytics：

10.16.0 - [FirebaseCrashlytics][I-CLS000000] Failed to download settings. 
If this is your first time launching the app, make sure you have enabled Crashlytics in the Firebase Console. 
Error Domain=FIRCLSNetworkError Code=-5 "(null)" UserInfo={status_code=404, type=2, request_id=, content_type=text/html; charset=utf-8}

排查与解决步骤 #

• 确认Firebase控制台Crashlytics已启用
  登录Firebase控制台对应项目，进入Crashlytics模块，完成初始化引导流程（比如上传首个崩溃报告或走完设置向导）。首次启用时，控制台需验证应用连接，未完成会直接触发404错误。

• 检查iOS项目配置文件有效性
  确保GoogleService-Info.plist是从Firebase控制台下载的最新版本，已正确添加到iOS项目的Runner目录，且在Xcode的Build Phases -> Copy Bundle Resources中包含该文件。

• 验证Pod依赖配置
  查看iOS项目Podfile，确认已添加Crashlytics相关依赖，执行pod install更新依赖：

  pod 'Firebase/Crashlytics'
  pod 'Firebase/Analytics'
  

  Flutter项目虽由firebase_core、firebase_crashlytics插件自动管理Pod，但手动检查可避免版本不兼容问题。

• 调整Xcode Build Settings

  1. 将DEBUG_INFORMATION_FORMAT在Debug和Release模式下均设为DWARF with dSYM File；
  2. 把ENABLE_BITCODE设置为NO（Crashlytics暂不支持Bitcode）。

• 手动触发崩溃验证连接
  在应用中添加测试崩溃逻辑（比如按钮点击事件执行assert(false)），触发崩溃后重启应用。首次成功上传崩溃报告后，Firebase控制台设置会同步，大概率解决404问题。

• 清理缓存重新构建

  1. 执行flutter clean清理Flutter缓存；
  2. 删除iOS项目Pods目录与Podfile.lock，重新执行pod install；
  3. 在Xcode中执行Product -> Clean Build Folder清理构建缓存，再重新编译运行。

• 排查网络环境
  确保测试设备能正常访问Firebase相关域名，排除代理、VPN或防火墙对Crashlytics请求的拦截。

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