Flutter Firebase初始化时出现PlatformException问题的解决求助

开发基于Flutter的任务管理应用，对接Firebase时，按要求通过WidgetsFlutterBinding.ensureInitialized()配合Firebase.initializeApp()完成初始化，同时使用GetX注入AuthController依赖，但运行应用时抛出返回null值的PlatformException错误。

main.dart代码 #

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:taskify/auth_controller.dart';
import 'package:taskify/screens/splash_screen.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp().then(
    (value) => Get.put(AuthController()),
  );
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const GetMaterialApp(
      home: SplashScreen(),
    );
  }
}

错误信息 #

E/flutter (20807): [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 (20807): #0      FirebaseCoreHostApi.optionsFromResource (package:firebase_core_platform_interface/src/pigeon/messages.pigeon.dart:248:7)
E/flutter (20807): <asynchronous suspension>
E/flutter (20807): #1      MethodChannelFirebase.initializeApp (package:firebase_core_platform_interface/src/method_channel/method_channel_firebase.dart:89:25)
E/flutter (20807): <asynchronous suspension>
E/flutter (20807): #2      Firebase.initializeApp (package:firebase_core/src/firebase.dart:43:31)
E/flutter (20807): <asynchronous suspension>
E/flutter (20807): #3      main (package:taskify/main.dart:9:3)
E/flutter (20807): <asynchronous suspension>
E/flutter (20807):

解决方案 #

• 检查Firebase配置文件完整性

  • Android：确认google-services.json已放置在android/app目录下，同时检查android/build.gradle中是否添加了Firebase插件依赖（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项目的根目录，并且在Build Phases的Copy Bundle Resources列表中存在该文件。

• 显式传入Firebase初始化参数
  若自动读取配置文件失败，可手动指定FirebaseOptions参数。先通过flutterfire configure命令生成适配当前平台的配置，然后修改初始化代码：

  import 'firebase_options.dart';
  
  Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    Get.put(AuthController());
    runApp(const MyApp());
  }
  

• 清理并重建项目

  • 执行flutter clean清除缓存
  • 运行flutter pub get重新拉取依赖
  • Android端可进入android目录执行./gradlew clean，iOS端可在Xcode中选择Product > Clean Build Folder后重新构建。

• 核对Firebase项目与应用的标识匹配度
  检查Firebase控制台中添加的应用包名（Android）或Bundle ID（iOS），确保与项目android/app/build.gradle、ios/Runner/Info.plist中的标识完全一致，注意大小写敏感。

• 优化GetX注入逻辑
  可将then回调改为更清晰的async/await写法，确保Firebase初始化完成后再注入控制器：

  await Firebase.initializeApp();
  Get.put(AuthController());
  

内容的提问来源于stack exchange，提问作者Sanjay Kumar Parida