Android Kotlin TabLayout下GA4与Firebase自定义事件触发两次问题

问题现象 #

事件埋点上线后出现重复上报问题：同一次用户操作触发的两次事件业务参数完全一致，仅ga_screen_id（Firebase Analytics DebugView中对应显示为firebase_screen_id）参数存在展示格式差异。
涉及的埋点实现代码如下：

fun setAnalyticsBanner(name: String, position: String){
    firebaseAnalytics.logEvent("banner") {
        param("os", OS)
        param("name", name)// 上报banner名称
        param("position", position)
    }
}

fun setAnalyticsConnectionStart(type: String, value: String){
    firebaseAnalytics.logEvent("connection_start") {
        param("type", type)
        param("value", value)
        param("os", OS)
    }
}

所有埋点方法均绑定在按钮的onClick点击回调中，排查后得到明确规律：

• 所有重复上报事件均来自TabLayout容器承载的Fragment页面
• TabLayout页面触发的两次事件ga_screen_id(_si)分别为-4412416303248681103（整型格式）、-4.412416303248681E18（浮点科学计数法格式），二者本质为同一数值
• 非TabLayout页面的同逻辑事件仅上报一次，对应ga_screen_id(_si)为-4412416303248681096

根因分析 #

1. 重复上报核心是ViewPager+TabLayout场景的监听重复绑定问题
   ViewPager默认会预加载左右相邻的Fragment，若在onViewCreated、onResume这类会反复触发的生命周期回调中注册点击监听，且未提前移除旧监听，会导致同一个按钮持有多个点击监听器实例，一次点击触发多次埋点调用。若Fragment实例化时传入的FragmentManager不匹配，还会出现同页面并存两个Fragment实例的情况，进一步加剧重复触发问题。
2. ga_screen_id格式差异是数值解析精度问题
   Firebase生成的ga_screen_id为64位长整型，当数值超过解析端（DebugView、前端调试工具）的最大安全整数范围（2^53-1）时，解析逻辑会自动将其转换为科学计数法的浮点格式展示，两个不同格式的ID实际为同一个值，不存在两个独立的屏幕实例。
3. 浮点格式ID仅在TabLayout场景出现的原因
   预加载的非可见Fragment不会被Firebase自动屏幕追踪逻辑标记为当前活动屏幕，SDK给这类非活跃实例分配的屏幕ID在DebugView做数据序列化解析时，会触发长整型转浮点的精度转换逻辑；非TabLayout页面不存在预加载并存的Fragment实例，SDK始终持有唯一的当前屏幕ID，解析时走整型展示逻辑，不会出现科学计数法格式。

修复方案 #

• 修正点击监听绑定逻辑，从源头避免重复触发
  不要在会重复执行的生命周期回调中反复注册点击监听：要么在onCreateView加载布局后仅绑定一次监听，要么每次绑定前先清空旧监听：

  // 绑定前先移除旧监听器
  binding.targetBtn.setOnClickListener(null)
  binding.targetBtn.setOnClickListener {
      setAnalyticsBanner("home_top", "header")
  }
  

  如果使用ViewPager2+Fragment，优先使用FragmentStateAdapter并传入正确的childFragmentManager，避免同页面生成多个Fragment实例。
• 手动管理Firebase屏幕上报，避免预加载Fragment干扰屏幕ID识别
  在AndroidManifest.xml中添加配置关闭Firebase自动屏幕追踪：

  <meta-data
      android:name="firebase_analytics_automatic_screen_reporting_enabled"
      android:value="false" />
  

  后续仅在Fragment真正对用户可见时（ViewPager场景监听onPageSelected回调、普通Fragment在onResume且可见性为true时），手动调用logEvent(FirebaseAnalytics.Event.SCREEN_VIEW, bundle)上报屏幕事件，保证SDK记录的当前活动屏幕唯一。
• 增加埋点防重兜底逻辑
  封装通用埋点方法，增加短时间同参数事件拦截逻辑，从业务层兜底拦截重复上报：

  private var lastEventTimestamp = 0L
  private var lastEventUniqueKey = ""
  
  fun logEventWithDuplicateCheck(eventName: String, params: Bundle) {
      val currentKey = buildString {
          append(eventName)
          params.keySet().forEach { key ->
              append("$key=${params.get(key)}")
          }
      }
      val currentTime = System.currentTimeMillis()
      // 500ms内相同参数的事件判定为重复，直接拦截
      if (currentTime - lastEventTimestamp < 500 && currentKey == lastEventUniqueKey) {
          return
      }
      lastEventTimestamp = currentTime
      lastEventUniqueKey = currentKey
      firebaseAnalytics.logEvent(eventName, params)
  }
  

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