Flutter项目中Firebase Analytics GA4事件仅卸载后显示问题排查

在Flutter项目中集成Firebase Analytics GA4后出现异常：只有在安装应用使用后卸载，事件和目标才会显示在Firebase实时分析中；不卸载应用的话，事件和目标始终不会出现在分析数据内。使用的事件上报代码如下：

static FirebaseAnalytics analytics = FirebaseAnalytics.instance;

analytics.logEvent(
  name: "selected_artist",
  parameters: filterOutNulls(
    <String, Object?>{"_ITEM_NAME": getStartModel.name}
  )
);

• 事件数据缓存未及时上传：Firebase Analytics默认会缓存事件数据，应用前台运行时不会立即上报，只有当应用进入后台、进程被杀死或卸载时才会批量上传。如果测试时一直让应用保持前台状态，数据会暂存本地缓存，不会实时同步到Firebase后台。
• 参数命名不符合GA4规范：你用的参数名_ITEM_NAME以下划线开头，GA4对自定义参数命名有要求，这类前缀的参数可能被系统过滤或无法正确识别，导致事件无法正常统计展示。建议改用item_name这类符合规范的命名。
• 初始化或配置存在问题：检查Android端的google-services.json、iOS端的GoogleService-Info.plist是否配置正确，有没有遗漏必要的网络权限，或者是否在代码中误禁用了Analytics的自动收集功能。
• 实时分析的展示限制：Firebase实时分析有一定延迟，仅展示最近30分钟内的事件，且要求设备与Firebase后台网络连接稳定。如果测试设备网络不稳定，或者事件触发后没等足够时间，就看不到实时数据；而卸载时的批量上传会一次性发送所有缓存数据，所以能看到记录。
• 未开启调试模式：生产环境下Firebase Analytics的事件上报频率会被限制，数据上传延迟更长。开启调试模式可以让事件实时上报，方便测试验证。

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