iOS端Firebase Debug View仅显示两类默认事件 其他事件无法捕获

按以下顺序逐一排查，90%以上的同类问题都能定位：

• 首先校验事件合法性
  Firebase Analytics对事件名、参数有严格的校验规则，不符合规则的事件会被SDK静默丢弃，无任何报错提示：
  • 事件名长度不超过40字符，仅支持大小写字母、数字、下划线，禁止使用firebase_、google_、ga_作为前缀，这类前缀为官方保留，自定义事件使用会直接被拦截
  • 单事件自定义参数不超过25个，参数值长度不超过100字符，非电商类预置事件不支持传入数组、字典等非标量类型参数
  • 不要传入空字符串、null/nil作为参数值，这类异常值同样会导致事件被丢弃
• 确认调试模式真实生效
  不要只检查启动参数是否添加，要以控制台日志为准：
  • -FIRDebugEnabled必须添加在当前运行Scheme的Arguments Passed On Launch列表中，不要误加到环境变量、Build Settings中
  • 完全卸载测试设备上的旧版App，清理Xcode DerivedData缓存后重新编译安装，启动后在Xcode控制台搜索debug mode关键词，确认存在Firebase Analytics debug mode enabled相关日志，才代表调试模式真正开启
  • 若使用TestFlight、AdHoc签名包测试，Xcode配置的启动参数不会生效，需要在代码中临时添加触发逻辑：启动后先调用Analytics.setAnalyticsCollectionEnabled(true)，再上报一次AnalyticsEventAppOpen事件，等待10秒左右让SDK完成调试流注册
• 检查上报链路和控制台选择
  • Debug View不是实时展示，执行logEvent后将App切到后台停留3-5秒再切回前台，强制触发SDK上报本地缓存的事件，多数时候事件只是存在本地缓存未触发上报逻辑，不会主动推送到控制台
  • 确认Firebase控制台Debug View右上角的设备选择下拉框，选中的是你当前正在测试的设备实例，切换网络、开关VPN、重装App都会生成新的设备实例，旧实例不会收到新上报的事件
  • 如果实现了Firebase Analytics的代理拦截方法，检查逻辑中是否误将自定义事件过滤拦截
• 排查配置冲突
  • 打开项目中的GoogleService-Info.plist，确认IS_ANALYTICS_ENABLED字段值为YES，该字段为配置文件级别的总开关，手动修改为NO后，仅靠代码调用开启收集会存在概率性不生效的问题
  • 检查是否设置了无效的用户ID、保留字段命名的用户属性，这类错误会导致SDK上报队列阻塞，仅能上报screen_view、user_engagement这类自动收集的基础事件，自定义事件全部卡在本地队列无法上报

快速验证方法：不要用自己写的自定义事件测试，直接上报官方预置的标准测试事件，代码如下：

// Swift示例
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
    AnalyticsParameterItemID: "debug_test_001",
    AnalyticsParameterItemName: "debug_test_item",
    AnalyticsParameterContentType: "debug_test"
])

执行完上述代码后切后台3秒再切回，等待10秒如果该预置事件可以正常显示，说明SDK链路和调试模式都正常，问题出在你自定义事件的格式、参数不符合规则；如果该预置事件也无法显示，直接卸载App重装、重新编译即可解决调试流注册失败的问题。

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