Flutter(Dart)项目Firebase初始化失败问题求助

针对你遇到的「Firebase has not been correctly initialized」报错，结合你的配置信息，整理以下排查步骤：

1. 确认Firebase配置文件完全正确添加 #

• Android端：确保google-services.json文件放在android/app目录下，文件内的package_name必须和app/build.gradle里的applicationId完全一致（你当前填的xxx要替换为实际包名）。
• iOS端：确认GoogleService-Info.plist是通过Xcode拖入项目的（不是仅复制文件到目录），拖入时要勾选对应的App Target，确保文件被纳入工程编译资源。

2. 严格控制初始化执行顺序 #

你的main代码结构没问题，但要确保：

• main函数必须是async的，且没有在Firebase.initializeApp()完成前调用任何Firebase服务（包括MyApp内部的initState、build方法，甚至静态变量引用）。
• 可以给初始化代码加上异常捕获，方便定位具体错误：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    try {
      await Firebase.initializeApp();
      print("Firebase初始化成功");
    } catch (e) {
      print("初始化失败详情: $e");
    }
    runApp(const MyApp());
  }
  

• 如果是多环境/Flavor项目，需要显式传入DefaultFirebaseOptions，可通过flutterfire_cli生成对应配置。

3. 统一Gradle插件版本 #

你的Android配置中google-services插件版本不一致：

• android/build.gradle里是4.3.14，android/settings.gradle里是4.4.0，统一改成同一个版本（推荐用4.4.0）：
  修改android/build.gradle的dependencies块：

  classpath "com.google.gms:google-services:4.4.0"
  

• 同时检查android/gradle/wrapper/gradle-wrapper.properties的distributionUrl，确保Gradle版本与插件匹配（gradle 7.3.1插件对应Gradle 7.4版本，即distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-all.zip）。

4. iOS端特殊配置检查 #

• 进入ios目录执行pod install（M1/M2芯片Mac建议用arch -x86_64 pod install），确保依赖安装完整。
• 检查ios/Podfile，确认platform :ios, '11.0'（firebase_core 2.20.0要求最低iOS 11.0），同时Xcode中App Target的Deployment Target也要设置为11.0或更高。
• 在Podfile中添加静态框架配置（Firebase官方推荐）：

  target 'Runner' do
    use_frameworks! :linkage => :static
    use_modular_headers!
    # 其他原有配置...
  end
  

5. 清理缓存并重建项目 #

• Flutter端：执行flutter clean → flutter pub get
• Android端：在Android Studio中点击「File → Invalidate Caches...」，勾选「Invalidate and Restart」
• iOS端：删除ios/Pods和ios/Podfile.lock，重新执行pod install，再在Xcode中按Command+Shift+K清理Build文件夹

6. 尝试调整依赖版本 #

如果以上步骤无效，可以尝试降低firebase_core版本到稳定版，比如^2.15.0，修改pubspec后执行flutter pub get重新安装。

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