Flutter聊天App调用Firebase.initializeApp()抛出PlatformException求助

问题背景 #

开发聊天App时，使用firebase_auth实现新用户注册功能，在main()函数初始化Firebase时抛出异常：

PlatformException(null-error, Host platform returned null value for non-null return value., null, null)

相关代码与配置如下：

main()函数代码 #

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

pubspec.yaml配置 #

name: flash_chat_app
description: A new Flutter project.

publish_to: 'none'

version: 1.0.0+1

environment:
  sdk: '>=2.18.6 <3.0.0'

dependencies:
  flutter:
    sdk: flutter

  cupertino_icons: ^1.0.2
  animated_text_kit: ^4.2.2
  firebase_core: ^2.12.0
  firebase_auth: ^4.6.0
  cloud_firestore: ^4.7.0

dev_dependencies:
  flutter_test:
    sdk: flutter

  flutter_lints: ^2.0.0

flutter:

  uses-material-design: true

  assets:
  - images/

已尝试flutter clean、flutter pub get、更新build.gradle等操作，问题未解决。

解决步骤 #

1. 验证Firebase配置文件完整性 #

• Android：确认google-services.json已放在android/app/目录下，内容和Firebase控制台生成的完全一致，没有遗漏字段。
• iOS：确认GoogleService-Info.plist已通过Xcode右键添加到项目（勾选"Copy items if needed"），且文件中的BUNDLE_IDENTIFIER和项目的Bundle ID完全匹配。

2. 修正Android端Build配置 #

• 项目根目录build.gradle中，确保Google Services插件版本正确：

  dependencies {
      // 其他依赖
      classpath 'com.google.gms:google-services:4.3.15' // 用最新兼容版本即可
  }
  

• app模块的build.gradle末尾，必须添加插件应用：

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

• 检查minSdkVersion不低于21，部分Firebase版本对最低SDK有要求。

3. 优化Firebase初始化代码 #

尝试加入异常捕获打印详细日志，或指定平台配置：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  try {
    // 如果用Firebase CLI配置过，可使用DefaultFirebaseOptions
    // await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
    await Firebase.initializeApp();
    runApp(FlashChat());
  } catch (e, stackTrace) {
    print("Firebase初始化失败详情: $e");
    print(stackTrace);
  }
}

如果没生成过DefaultFirebaseOptions，可以用flutterfire configure命令自动生成适配多平台的配置类。

4. 同步Firebase依赖版本 #

当前依赖版本可能存在兼容性问题，尝试更新到最新兼容版本：

dependencies:
  firebase_core: ^2.24.2
  firebase_auth: ^4.15.0
  cloud_firestore: ^4.13.0

更新后执行flutter pub get，再做一次flutter clean。

5. 修复iOS端依赖问题 #

• 进入iOS目录执行cd ios && pod deintegrate && pod install，彻底清理并重新安装CocoaPods依赖。
• 确认Xcode项目的签名配置正确，没有证书或权限问题。

6. 彻底清理项目后重建 #

• 执行flutter clean
• 删除Android目录下的.gradle文件夹
• 删除iOS目录下的Pods和Podfile.lock
• 重新运行flutter run

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