Flutter应用初始化Firebase遇PlatformException错误求助

问题场景 #

此前Flutter应用运行正常，修改main.dart为以下代码后出现初始化失败：

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

报错信息：

E/flutter ( 6526): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(null-error, Host platform returned null value for non-null return value., null, null)
E/flutter ( 6526): #0      FirebaseCoreHostApi.optionsFromResource (package:firebase_core_platform_interface/src/pigeon/messages.pigeon.dart:248:7)
E/flutter ( 6526): <asynchronous suspension>
E/flutter ( 6526): #1      MethodChannelFirebase.initializeApp (package:firebase_core_platform_interface/src/method_channel/method_channel_firebase.dart:107:9)
E/flutter ( 6526): <asynchronous suspension>
E/flutter ( 6526): #2      Firebase.initializeApp (package:firebase_core/src/firebase.dart:43:31)
E/flutter ( 6526): <asynchronous suspension>
E/flutter ( 6526): #3      main (package:electralink/main.dart:11:3)
E/flutter ( 6526): <asynchronous suspension>
E/flutter ( 6526): 

解决方案 #

• 验证Firebase配置文件

  • Android：确认google-services.json放在android/app/目录下，同时检查gradle配置：
    项目级android/build.gradle：

    buildscript {
      dependencies {
        classpath 'com.google.gms:google-services:4.4.0' // 使用最新兼容版本
      }
    }
    

    应用级android/app/build.gradle末尾添加：

    apply plugin: 'com.google.gms.google-services'
    

  • iOS：确认GoogleService-Info.plist已通过Xcode右键添加（勾选"Copy items if needed"），且ios/Podfile中配置正常。

• 手动指定初始化选项
  若自动读取配置失败，手动传入平台配置：

  Future main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    runApp(MyApp());
  }
  

  需确保已执行flutterfire configure生成DefaultFirebaseOptions，并完成flutter pub get。

• 清理重建项目

  • 执行flutter clean清除Flutter缓存
  • Android端：进入android/目录，运行./gradlew clean
  • iOS端：进入ios/目录，运行pod deintegrate && pod install
  • 重新启动项目

• 检查依赖版本兼容性
  确认firebase_core及其他Firebase插件版本与当前Flutter SDK兼容，更新到合适版本后执行flutter pub get。

• 升级工具版本

  • 升级Flutter到稳定版：flutter upgrade
  • 升级Firebase CLI：npm install -g firebase-tools，之后重新执行flutterfire configure

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