MacOS下Flutter Web的FlutterFire InitializeApp()无报错但初始化失败

问题根因 #

• 初始化逻辑写法错误：initializeFlutterFire()是异步方法，你在initState里直接调用没有等待执行结果，定义的_initialized、_error状态变量完全没被使用，初始化流程还在pending的时候，build方法已经直接渲染了业务组件SurveyWidget，后续调用Firestore时拿不到有效初始化实例，表现为初始化未完成。
• Web端必要前置配置缺失：Flutter Web场景下Firebase初始化依赖index.html中引入的Firebase Web SDK脚本，漏加这段脚本时，Dart侧的initializeApp()调用不会同步抛出错误，只会卡在异步等待环节。
• 配置参数非法+冗余参数问题：你代码里硬编码的FirebaseOptions中appId是无效占位值，同时额外传了自定义name: 'sims'参数，单Flutter Web应用场景下自定义实例名会导致后续Firestore等服务无法匹配到默认初始化实例，参数非法时Web端的校验是异步执行的，不会同步抛错，只会让初始化流程一直处于未完成状态。
• 未做初始化状态拦截：不管初始化成功、失败还是加载中，你的build逻辑都直接渲染业务页，既没有加载态提示，也没有错误捕获，根本感知不到初始化过程的异常。

修复方案 #

• 先补全web/index.html的前置依赖：在web/index.html的<body>标签最顶部，加入和你当前firebase_core版本匹配的Firebase Web核心脚本，不需要额外引入其他服务脚本，firebase_core会自动按需加载。
• 废弃硬编码的配置参数，直接使用flutterfire生成的配置：你已经执行过flutterfire configure生成了firebase_options.dart，直接引入该文件，使用DefaultFirebaseOptions.currentPlatform作为初始化参数即可，不要传自定义name参数，单应用场景下不需要命名Secondary实例，传name反而会导致服务找不到默认实例。
• 重构初始化逻辑，做好状态拦截：推荐直接在main函数中完成初始化，逻辑最简单也最不容易出问题，代码如下：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:cloud_firestore/cloud_firestore.dart';
import 'firebase_options.dart';

void main() async {
  // 必须先确保Flutter插件绑定初始化
  WidgetsFlutterBinding.ensureInitialized();
  // 等待Firebase初始化完成再runApp
  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  runApp(const MyApp());
}

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(body: SurveyWidget()),
    );
  }
}

如果确实需要在State内做初始化，必须在初始化回调中更新状态，根据初始化结果渲染对应页面，不要在初始化未完成时直接渲染业务组件，参考代码：

class _MyAppState extends State<MyApp> {
  bool _initialized = false;
  String? _initError;

  @override
  void initState() {
    super.initState();
    initFirebase();
  }

  Future<void> initFirebase() async {
    try {
      await Firebase.initializeApp(
        options: DefaultFirebaseOptions.currentPlatform,
      );
      if (mounted) {
        setState(() {
          _initialized = true;
        });
      }
    } catch (e) {
      if (mounted) {
        setState(() {
          _initError = e.toString();
        });
      }
    }
  }

  @override
  Widget build(BuildContext context) {
    if (_initError != null) {
      return MaterialApp(
        home: Scaffold(
          body: Center(child: Text('Firebase初始化失败：$_initError')),
        ),
      );
    }
    if (!_initialized) {
      return const MaterialApp(
        home: Scaffold(
          body: Center(child: CircularProgressIndicator()),
        ),
      );
    }
    return MaterialApp(home: Scaffold(body: SurveyWidget()));
  }
}

注意：不要手动硬编码Firebase配置项，尤其是appId、storageBucket这类和项目强绑定的参数，手动填写很容易出现字符错漏导致初始化静默失败，直接用flutterfire命令生成的配置文件是最稳妥的方式。

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