Flutter运行报[core/not-initialized] Firebase未正确初始化问题咨询

AI 小北

2026-8-30

异常说明

运行应用时抛出FirebaseException，错误标识为[core/not-initialized]，错误信息为 Firebase has not been correctly initialized。
故障触发场景：故障前一晚应用可正常构建、运行，间隔期未修改任何项目代码，次日启动应用时直接触发该报错。
当前使用的初始化代码如下：

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

核心诱发原因

构建缓存损坏：这是无代码改动场景下触发该错误的最高频原因。Flutter、Gradle、CocoaPods的增量构建缓存出现异常时，会导致Android端google-services.json、iOS端GoogleService-Info.plist这类Firebase配置文件没有被正确打包进安装包，初始化时读取不到配置自然抛出异常。
依赖版本浮动冲突：如果pubspec.yaml中Firebase相关依赖没有锁死版本（使用了^开头的版本约束），执行flutter pub get时会自动拉取符合约束的最新版依赖，一旦新版firebase_core和其他Firebase插件、平台原生SDK存在版本不兼容，就会导致初始化流程中断。
初始化调用缺省配置参数：高版本firebase_core不再完全依赖平台侧自动读取配置文件，不带options参数直接调用Firebase.initializeApp()时，部分构建场景下无法自动匹配到当前平台的配置参数，就会判定为未正确初始化。
平台配置关联失效：Android端google-services插件配置丢失、iOS端GoogleService-Info.plist未被加入Xcode target编译资源，这类问题可能在IDE执行非全量构建时才会暴露，平时全量构建时不会触发。

修复步骤（按优先级从高到低操作）

全量清理构建缓存，优先排除缓存问题
在项目根目录依次执行以下命令，完成后重新运行应用：

flutter clean
flutter pub get
# Android端额外执行Gradle清理
cd android && ./gradlew clean && cd ..
# iOS端额外执行CocoaPods重装
cd ios && pod deintegrate && pod install --repo-update && cd ..

补全初始化参数，显式传入平台配置
替换原有main函数中的初始化代码，显式指定当前平台的Firebase配置，避免自动读取失败：
```
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}
```
如果项目中不存在DefaultFirebaseOptions配置类，直接在项目根目录执行flutterfire configure命令，按指引关联对应Firebase项目，命令会自动生成全平台适配的配置文件，不需要手动拷贝各端的Google服务配置文件。
锁定Firebase依赖版本
打开pubspec.yaml文件，找到所有Firebase相关依赖（包括firebase_core、firebase_auth、cloud_firestore等），移除版本号前的^符号，固定为之前正常运行时的版本号，执行flutter pub get后重新构建即可。
检查平台侧配置关联
- Android端：确认google-services.json文件存放在android/app/目录下，且app层级的build.gradle文件中正确应用了com.google.gms.google-services插件
- iOS端：用Xcode打开iOS工程，检查Build Phases下的Copy Bundle Resources列表中是否包含GoogleService-Info.plist，如果没有就手动拖入添加。

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