iOS应用未在Firebase Analytics控制台显示问题排查求助
SPM接入Firebase Analytics无数据排查方案
基础配置校验
- 核对
GoogleService-Info.plist内的BUNDLE_ID字段值,与项目主target的Bundle Identifier完全一致,注意大小写、后缀不要出现拼写误差 - 确认
GoogleService-Info.plist已经被添加到主target的Copy Bundle Resources构建阶段,没有被遗漏或者仅添加到测试target - 确认Firebase控制台当前项目的iOS应用列表中,对应Bundle ID的应用存在,没有被误删或者创建到其他项目分组下
SPM依赖配置校验
- 确认SPM引入的
FirebaseAnalytics依赖已经关联到主target,没有仅绑定测试/扩展target - 检查项目构建设置的
Other Linker Flags项,确认已添加-ObjC标记:Analytics的类别实现依赖该标记才能被正确加载,Firestore无此依赖所以可正常运行,这是SPM接入时最常遗漏的配置点 - 确认所有Firebase相关依赖的版本号完全统一,跨版本混用会导致部分功能初始化异常
运行时上报校验
- 日志中的
nw_protocol_get_quic_image_block_invoke dlopen libquic failed报错属于iOS系统底层QUIC协议加载异常,和Firebase Analytics功能无关,无需处理 - 开启Analytics调试日志:点击Scheme -> Edit Scheme -> Run -> Arguments -> Environment Variables,添加
FIRDebugEnabled字段,值设为YES,运行项目后查看控制台是否输出Firebase Analytics is ready to receive events日志,无该日志则说明Analytics初始化失败 - 若初始化日志正常,继续查找
Uploading data to Firebase Analytics日志,有该输出则说明本地上报逻辑正常,Firebase控制台最多需要24小时同步数据,刚上报后无显示属于正常情况 - 检查项目
Info.plist中是否存在FIREBASE_ANALYTICS_COLLECTION_ENABLED字段,若存在且值为NO,删除该字段或将值改为YES,该配置会强制关闭Analytics数据上报
极端场景排查
- 检查测试设备隐私设置:设置 -> 隐私与安全性 -> 跟踪,确认允许App请求跟踪;若未接入ATT框架,确认未手动关闭Analytics的无IDFA上报开关
- 确认测试设备未挂代理、VPN,网络防火墙未拦截
*.google-analytics.com、*.firebaseio.com域名的请求 - 不要长时间使用模拟器Debug模式反复测试上报,Firebase会自动屏蔽短时间内上报频次过高的测试设备,可更换真机或重置模拟器后再测试
内容的提问来源于stack exchange,提问作者chrispsv
相关产品推荐
相关产品推荐

