Flutter中Firebase '[DEFAULT]'未初始化错误求助

核心问题分析 #

你初始化Firebase时指定了name参数，这会创建一个命名实例，但Firebase Auth、Firestore等服务默认会尝试调用**[DEFAULT]默认实例**，两者不匹配就会触发该错误。

具体修复方案 #

方案1：创建默认实例（推荐） #

如果不需要多Firebase实例，直接初始化默认实例，不要指定name参数：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}

方案2：绑定命名实例调用服务 #

如果确实需要使用命名实例，所有Firebase服务调用都必须指定对应的实例：

// 初始化命名实例
final FirebaseApp myApp = await Firebase.initializeApp(
  name: 'myApp',
  options: DefaultFirebaseOptions.currentPlatform,
);

// 调用Auth时绑定实例
final FirebaseAuth auth = FirebaseAuth.instanceFor(app: myApp);
// 执行注册操作
await auth.createUserWithEmailAndPassword(email: 'xxx@example.com', password: 'yourpassword');

额外排查点 #

• 确保WidgetsFlutterBinding.ensureInitialized()在Firebase初始化代码之前执行，否则会导致初始化流程异常。
• 检查pubspec.yaml中firebase_core与其他Firebase插件（如firebase_auth）的版本是否兼容，建议使用最新稳定版。
• Android端确认google-services.json放在android/app/根目录；iOS端确认GoogleService-Info.plist已通过Xcode添加到项目（不是仅复制到文件夹）。
• 清理项目缓存：执行flutter clean → flutter pub get，重新编译运行项目。

内容的提问来源于stack exchange，提问作者Edens Fallen Leaf