Flutter使用cloud_firestore出现Firebase App未初始化报错如何解决

问题定位与解决方案 #

1. 修复Firebase JS SDK版本不兼容问题 #

你当前在index.html中引入的8.6.1版本Firebase JS SDK，与新版flutterfire全家桶（firebase_core、cloud_firestore等）默认适配的9.x/10.x版本不匹配，这是初始化失败的高频原因。
你可以选择两种修复方式：

• 全部删除index.html中手动引入的Firebase相关script标签，现在新版flutterfire已经支持自动引入对应版本的JS SDK，无需手动配置
• 如果你需要手动引入，要保证所有Firebase相关JS SDK版本完全一致，且和pubspec.yaml中firebase_core的版本适配

2. 核对main函数初始化顺序 #

初始化代码必须严格遵循以下顺序，顺序颠倒会导致初始化不生效：

void main() async {
  // 优先初始化Widgets绑定
  WidgetsFlutterBinding.ensureInitialized();
  // 再完成Firebase初始化
  await Firebase.initializeApp(
    // Web平台必须传入对应配置参数，不能留空
    options: const FirebaseOptions(
      apiKey: "你的Firebase web项目apiKey",
      appId: "你的Firebase web项目appId",
      messagingSenderId: "你的项目senderId",
      projectId: "你的项目id",
      // 剩余参数从Firebase控制台web配置中复制即可
    ),
  );
  // 最后启动应用
  runApp(const MyApp());
}

注意如果是运行在Web平台，必须给Firebase.initializeApp传入web端的配置参数，留空也会触发初始化失败报错。

3. 清理缓存重新构建 #

本地残留的旧构建产物可能会导致报错不消失，依次执行以下命令清理后重新运行即可：

flutter clean
flutter pub get
flutter run -d chrome

代码优化建议 #

你当前的日期转换函数逻辑冗余，Timestamp.fromDate(date).millisecondsSinceEpoch本身就是int类型，无需转字符串再做解析，可以直接简化为：

int convertDate(DateTime date) {
  return Timestamp.fromDate(date).millisecondsSinceEpoch;
}

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