Flutter中Firebase初始化报错[core/not-initialized]求解决方案

问题描述 #

FirebaseException ([core/not-initialized] Firebase尚未正确初始化。通常这意味着在调用Firebase.initializeApp()之前就尝试使用了Firebase服务。

用户提供的main.dart代码：

Future main() async {
    WidgetsFlutterBinding.ensureInitialized();
    if (kIsWeb) {
        await Firebase.initializeApp(
        options: const FirebaseOptions(
        apiKey: "AIzaSyDJQ6ymkbfS3YMtGM-jiK2k3sUnHnCQNC8",
        // authDomain: "flutter-ois-fafc4.firebaseapp.com",
        projectId: "flutter-ois-fafc4",
        // storageBucket: "flutter-ois-fafc4.appspot.com",
        messagingSenderId: "950521712293",
        appId: "1:950521712293:web:d8ac01ada3067c3e7b474c",
        // measurementId: "G-98JPJ4HZGT"
  ));
  } else {
        await Firebase.initializeApp();
  }

  runApp(
  DevicePreview(
  // enabled: true,
  builder: (context) => const MyApp(), // Wrap your app
 ),
);
}

项目依赖：

firebase_core: ^2.21.0  
firebase_storage: ^11.4.1
firebase_database: ^10.3.3
cloud_firestore: ^4.12.2
firebase_auth: ^4.12.1

排查与解决步骤 #

1. 补全非Web平台的Firebase配置文件 #

Android和iOS平台不能仅靠代码初始化，必须添加官方配置文件：

• Android：将Firebase控制台下载的google-services.json放在android/app/目录下，同时确保android/build.gradle和android/app/build.gradle中已配置Google服务插件。
• iOS：将GoogleService-Info.plist放在ios/Runner/目录下，通过Xcode添加到项目中（勾选"Copy items if needed"）。

2. 确保初始化完成后再渲染业务组件 #

检查MyApp或其子组件是否存在提前调用Firebase服务的情况（比如在initState中直接访问Firestore/Auth）。可以用FutureBuilder确保初始化完成后再渲染：

Future main() async {
  WidgetsFlutterBinding.ensureInitialized();
  late FirebaseApp app;
  if (kIsWeb) {
    app = await Firebase.initializeApp(
      options: const FirebaseOptions(
        apiKey: "AIzaSyDJQ6ymkbfS3YMtGM-jiK2k3sUnHnCQNC8",
        projectId: "flutter-ois-fafc4",
        messagingSenderId: "950521712293",
        appId: "1:950521712293:web:d8ac01ada3067c3e7b474c",
        // 若用到Auth/Storage，取消注释并补全对应字段
        // authDomain: "flutter-ois-fafc4.firebaseapp.com",
        // storageBucket: "flutter-ois-fafc4.appspot.com",
      ),
    );
  } else {
    app = await Firebase.initializeApp();
  }

  runApp(
    DevicePreview(
      builder: (context) => FutureBuilder(
        future: Firebase.initializeApp(app: app),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.done) {
            return const MyApp();
          }
          // 显示加载占位，避免提前触发Firebase调用
          return const Center(child: CircularProgressIndicator());
        },
      ),
    ),
  );
}

3. 修复Web平台配置缺失 #

如果你的Web应用用到了Firebase Auth或Storage服务，必须取消FirebaseOptions中对应字段的注释并填写正确值，缺失的配置会导致对应服务初始化失败，进而触发全局未初始化异常。

4. 清理缓存并重新构建 #

执行以下命令确保依赖和配置生效：

flutter clean
flutter pub get
flutter run

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