Firebase iOS端近一月用户数据异常（重复统计）排查咨询

1. 核查UserID设置逻辑 #

• 确认iOS端调用setUserId()的时机：必须在用户登录成功后仅执行一次，排查是否存在App启动、页面切换等场景下重复调用的情况——重复调用会让Firebase为同一UserID关联多条设备记录。
• 检查异步流程：比如登录接口的回调是否存在重复触发、未做幂等处理的问题，导致setUserId()被多次执行。

2. 检查设备标识稳定性 #

• 打印并验证appInstanceId：在iOS端添加日志，输出Analytics.appInstanceID()的返回值，观察同一设备多次启动App时，该ID是否保持一致。如果每次都生成新ID，会导致Firebase识别为不同设备。
• 确认ATT框架影响：检查用户是否开启了「限制广告跟踪」，虽然正常情况下这不会导致同一UserID关联多设备，但可以排查是否有自定义逻辑干扰了Firebase的设备标识获取。

3. 排查会话统计逻辑 #

• 检查默认会话规则：Firebase默认以App后台切前台超过30秒作为新会话触发条件，确认是否有自定义会话事件（比如手动调用Analytics.logEvent(name: "session_start")），是否存在误触发（比如后台唤醒时频繁调用）。
• 查看后台模式配置：如果App开启了后台刷新、推送唤醒等功能，排查是否这些场景导致App在后台触发会话统计，进而生成额外的活跃会话。

4. 验证SDK集成与版本 #

• 对比SDK升级时间：如果异常出现的时间刚好是iOS端Firebase SDK升级的节点，尝试回退到之前统计正常的版本，验证问题是否消失。
• 检查集成配置：确认GoogleService-Info.plist配置正确，没有重复添加Firebase相关依赖或配置项，避免SDK初始化异常。

5. 数据验证与复现测试 #

• 手动复现问题：用固定测试账号在iOS设备上操作（多次启动App、切换前后台、重启设备），然后在Firebase控制台查看该UserID的关联设备数和会话数，确认是否能复现。
• 导出原始数据分析：通过Firebase Analytics的导出功能获取原始事件数据，筛选该UserID的user_engagement事件，对比每个事件的app_instance_id和device_info字段，定位重复数据的来源。

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