Flutter Web已初始化Firebase仍报[DEFAULT]应用未创建错误求助

核心原因 #

你调用Firebase.initializeApp()时指定了name参数，这会创建一个命名Firebase实例，但FirebaseAuth、Firestore的默认实例（如FirebaseAuth.instance）只会关联名为[DEFAULT]的App。如果没有初始化[DEFAULT]实例，或者在初始化完成前就访问Firebase服务，就会触发该错误。

具体解决步骤 #

1. 初始化[DEFAULT]实例 #

如果不需要命名实例，直接不带name参数初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(
    options: FirebaseOptions(
      apiKey: "你的API_KEY",
      authDomain: "你的AUTH_DOMAIN",
      projectId: "你的PROJECT_ID",
      storageBucket: "你的STORAGE_BUCKET",
      messagingSenderId: "你的SENDER_ID",
      appId: "你的APP_ID",
      measurementId: "你的MEASUREMENT_ID",
    ),
  );
  runApp(const MyApp());
}

如果确实需要命名实例，同时初始化[DEFAULT]实例：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 先初始化默认实例
  await Firebase.initializeApp(options: FirebaseOptions(...));
  // 再初始化命名实例（按需）
  await Firebase.initializeApp(
    name: "myNamedApp",
    options: FirebaseOptions(...),
  );
  runApp(const MyApp());
}

2. 确保初始化完成后再访问Firebase服务 #

必须等待Firebase.initializeApp()的异步操作完成后，再调用FirebaseAuth.instance或FirebaseFirestore.instance。可以用FutureBuilder确保初始化完成再渲染页面：

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return FutureBuilder(
      future: Firebase.initializeApp(options: FirebaseOptions(...)),
      builder: (context, snapshot) {
        if (snapshot.connectionState == ConnectionState.done) {
          return MaterialApp(home: HomePage());
        }
        return const Center(child: CircularProgressIndicator());
      },
    );
  }
}

3. 检查Web端配置一致性 #

确保web/index.html中的Firebase配置与Flutter代码里的FirebaseOptions完全一致，避免配置冲突：

<!-- 在body末尾添加 -->
<script type="module">
  import { initializeApp } from "https://www.gstatic.com/firebasejs/9.22.0/firebase-app.js";
  const firebaseConfig = {
    apiKey: "你的API_KEY",
    authDomain: "你的AUTH_DOMAIN",
    projectId: "你的PROJECT_ID",
    storageBucket: "你的STORAGE_BUCKET",
    messagingSenderId: "你的SENDER_ID",
    appId: "你的APP_ID",
    measurementId: "你的MEASUREMENT_ID"
  };
  initializeApp(firebaseConfig);
</script>

4. 关联命名实例到Auth/Firestore（按需） #

如果必须使用命名实例，访问服务时要明确指定对应的App实例：

// 获取命名实例
final FirebaseApp namedApp = Firebase.app("myNamedApp");
// 关联到Auth
final FirebaseAuth auth = FirebaseAuth.instanceFor(app: namedApp);
// 关联到Firestore
final FirebaseFirestore firestore = FirebaseFirestore.instanceFor(app: namedApp);

// 使用实例操作
final user = auth.currentUser;

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