Flutter初始化Firebase遇Platform Exception错误求解决

• 纠正依赖误区
  firebase_core_performance是Firebase性能监控工具的依赖，和Firebase核心初始化无关，你需要确保pubspec.yaml中添加了**firebase_core**这个核心依赖，执行flutter pub add firebase_core添加后，再运行flutter pub get同步依赖。

• 核对平台配置文件

  • Android：确认android/app/google-services.json是从Firebase控制台下载的对应项目文件，包名和控制台里的完全一致；同时检查android/build.gradle中是否引入了com.google.gms:google-services插件，android/app/build.gradle末尾是否有apply plugin: 'com.google.gms.google-services'配置。
  • iOS：确认ios/Runner/GoogleService-Info.plist正确下载并添加到Xcode项目中（添加时要勾选“Copy items if needed”并关联到Runner目标），Bundle ID必须和Firebase控制台的完全匹配。

• 检查初始化代码逻辑
  初始化Firebase必须在runApp之前执行，且要先绑定Flutter框架，正确示例代码：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    runApp(const MyApp());
  }
  

  漏加WidgetsFlutterBinding.ensureInitialized()是异步初始化失败的常见原因。

• 彻底清理重建项目
  执行以下命令清理所有缓存后重新构建：

  flutter clean
  flutter pub get
  # Android额外清理步骤
  cd android && ./gradlew clean && cd ..
  # iOS额外清理步骤
  cd ios && pod deintegrate && pod install && cd ..
  flutter run
  

• 验证版本兼容性
  确保Firebase Flutter插件版本和当前Flutter SDK版本兼容，可查看Firebase官方文档的版本兼容说明，避免因版本不匹配引发异常。

• 基础环境检查
  确认设备/模拟器有正常网络连接，Android项目的AndroidManifest.xml中已声明<uses-permission android:name="android.permission.INTERNET"/>权限。

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