Flutter iOS端Firebase Analytics无数据问题排查求助

• 检查Firebase配置文件一致性
  确认GoogleService-Info.plist的正确性：

  • 核对文件中的BUNDLE_ID与TestFlight使用的应用bundle ID完全匹配（大小写敏感）
  • 确保该文件已添加到Xcode项目的Copy Bundle Resources构建阶段，不会被遗漏
  • 检查plist内IS_ANALYTICS_ENABLED字段值为YES，GOOGLE_APP_ID与Firebase控制台对应应用的ID一致

• 验证签名与权限配置

  • 确认Firebase控制台已关联TestFlight分发所用的Provisioning Profile（对应App Store Distribution证书）
  • 在Xcode的Signing & Capabilities中，确保Analytics能力已启用，同时勾选Background Modes下的Remote notifications（部分场景下需此保证事件上报通路）

• 注意Analytics数据延迟特性
  Firebase针对TestFlight的Analytics数据存在24-48小时的延迟，并非实时更新。若刚发布Beta版，先等待足够时间再查看数据。
  本地调试验证方法：用Xcode运行TestFlight归档包，在控制台搜索FirebaseAnalytics日志，确认事件是否正常上报。

• 检查Flutter Firebase插件配置

  • 确保firebase_core和firebase_analytics为最新稳定版本，避免版本兼容问题
  • 在main.dart中确认Firebase初始化代码正确：

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    

  • 可手动添加测试事件验证，比如在应用启动时上报：

    FirebaseAnalytics.instance.logEvent(name: 'test_flight_launch');
    

    安装TestFlight版本后触发事件，等待延迟后查看控制台是否能看到该事件。

• 处理iOS 14+跟踪权限
  iOS 14及以上系统需要用户授权跟踪才能收集Analytics数据：

  • 在Info.plist中添加权限描述：

    <key>NSUserTrackingUsageDescription</key>
    <string>收集应用使用数据以优化您的体验</string>
    

  • 确保应用中已请求跟踪权限，且用户在设备设置>隐私与安全性>跟踪中允许该应用跟踪

• 排查控制台过滤条件
  检查Firebase Analytics页面的日期范围和过滤设置，避免误选“仅开发设备”等限制条件，确保查看的是所有用户数据

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