Flutter初始化Firebase报PlatformException(null-error)异常

抛出PlatformException(null-error, Host platform returned null value for non-null return value.)的核心原因是Firebase Core无法从原生宿主层读取到合法的初始化配置，你既没有完成安卓/iOS端的Firebase原生配置，Dart侧初始化代码也缺失了必填的配置参数。

1. 补全原生平台基础配置 #

• 安卓端：
  • 登录Firebase控制台，下载当前项目对应的google-services.json配置文件，放到Flutter项目的android/app目录下，注意不要放错目录层级。
  • 打开android/build.gradle文件，在buildscript.dependencies节点下添加谷歌服务插件依赖：

    buildscript {
      dependencies {
        // 保留原有所有依赖，新增下面这行
        classpath 'com.google.gms:google-services:4.3.15'
      }
    }
    

  • 打开android/app/build.gradle文件，在文件最末尾添加插件应用声明：

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

  • 确认该文件内的minSdkVersion配置不低于21，FCM最低支持Android API level 21。
• iOS端：
  • 从Firebase控制台下载当前项目对应的GoogleService-Info.plist文件，通过Xcode打开iOS项目，将文件拖入Runner目录下，勾选Copy items if needed选项完成导入。

2. 生成Dart侧Firebase配置并修正初始化代码 #

• 先安装FlutterFire CLI工具，在终端执行：

  dart pub global activate flutterfire_cli
  

• 安装完成后在项目根目录执行配置命令，按照引导登录谷歌账号、选择对应的Firebase项目、勾选需要支持的平台：

  flutterfire configure
  

• 命令执行完成后，lib目录下会自动生成firebase_options.dart配置文件，修改main.dart的代码：
  1. 新增配置文件导入：

     import 'firebase_options.dart';
     

  2. 修正main函数中的初始化逻辑，传入必填的options参数：

     void main() async {
       WidgetsFlutterBinding.ensureInitialized();
       // 补全options参数，不要留空
       await Firebase.initializeApp(
         options: DefaultFirebaseOptions.currentPlatform,
       );
     
       FirebaseMessaging.onBackgroundMessage(_firebadeMessagingBackgroundHandler);
     
       runApp(const MyApp());
     }
     

  3. 同步修正后台消息处理函数中的初始化逻辑，同样传入配置参数：

     Future<void> _firebadeMessagingBackgroundHandler(RemoteMessage message) async {
       await Firebase.initializeApp(
         options: DefaultFirebaseOptions.currentPlatform,
       );
       print('Handling a background message ${message.messageId}');
     }
     

3. 清理缓存重新编译 #

所有配置修改完成后，完全关闭当前运行的应用，执行以下命令清理构建缓存后重新编译运行，不要使用热重载/热重启：

flutter clean
flutter pub get
flutter run

如果按照上面步骤操作后仍然报错，检查以下问题：

• 下载的平台配置文件要和你Firebase控制台的项目包名/bundle ID完全匹配，包名不一致会导致配置读取失败。
• 不要在国内网络环境下执行初始化相关的构建操作，避免依赖拉取不全。
• 确认pubspec.yaml中firebase_core、firebase_messaging的版本和你当前使用的Flutter SDK大版本兼容，不要跨大版本混用依赖。

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