Firebase控制台未显示Crashlytics崩溃报告问题求助

问题现象 #

Xcode控制台已输出「[Firebase/Crash][I-CRA000004] Successfully initialised」，确认Crashlytics初始化正常，但手动触发应用崩溃后，Firebase控制台始终显示「App detected we're waiting for a crash」，无任何崩溃报告提交。已按官方文档完成以下配置：

• 添加Google Service Info.plist文件
• 配置构建脚本及其输入文件
• 在Build Phases末尾添加${PODS_ROOT}/FirebaseCrashlytics/run脚本
• 尝试过CocoaPods与Swift Packages两种集成方式

排查解决步骤 #

• 调试器附加状态下无法捕获崩溃
  Crashlytics不会记录调试器连接时的崩溃。必须先断开Xcode与设备的连接（停止调试，拔掉数据线或断开无线调试），手动触发崩溃后，等待系统自动重启应用，Crashlytics会在应用重启时上报崩溃报告。

• 核对构建脚本配置细节
  确保run脚本位于Build Phases的最后一步，且输入文件配置完整：

  • 输入文件需包含：
    • $(SRCROOT)/$(PRODUCT_NAME)/GoogleService-Info.plist
    • $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)
      同时确认脚本在需要捕获崩溃的构建模式（Debug/Release）下均已启用。

• 确认初始化时机无延迟
  将Firebase初始化代码放在AppDelegate的application(_:didFinishLaunchingWithOptions:)方法最开头，或iOS 13+的SceneDelegate的scene(_:willConnectTo:options:)方法中，避免被其他业务代码阻塞或延迟初始化。

• 检查网络与后台权限

  • 确保设备处于正常网络环境（WiFi或蜂窝网络），崩溃报告需联网才能上传至Firebase服务器。
  • 前往设备「设置-通用-后台App刷新」，确认目标应用的后台刷新权限已开启，避免系统阻止应用在后台上传报告。

• 清理缓存重新构建

  • 删除设备上的目标应用，清理Xcode的Derived Data（路径：Xcode -> 设置 -> 位置 -> Derived Data，删除对应项目的文件夹）。
  • 重新构建并安装应用，断开调试器后触发崩溃，等待5-10分钟再查看Firebase控制台（报告同步存在延迟）。

• 验证plist文件配置正确性
  检查GoogleService-Info.plist中的PROJECT_ID、CRASHLYTICS_API_KEY等字段，确保与Firebase控制台对应项目的配置完全匹配，避免因选错项目或环境导致报告无法上传。

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