Flutter桌面端Firebase Firestore获取数据报错MissingPluginException求助

这个错误的核心原因是Firebase Firestore的桌面端原生实现未正确配置或初始化，导致Flutter无法找到对应的平台插件实现。以下是针对性的解决步骤：

1. 配置Firebase CLI并初始化桌面项目 #

• 先安装Firebase CLI：执行npm install -g firebase-tools，完成后用firebase login登录你的Firebase账号。
• 进入项目根目录，执行flutterfire configure，按照提示选择目标Firebase项目，必须勾选桌面平台（Windows/macOS/Linux），该命令会自动生成适配桌面端的Firebase配置文件。

2. 检查并更新依赖 #

确保pubspec.yaml中包含兼容的Firebase依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.15.0
  cloud_firestore: ^4.9.0
  # 其他项目依赖...

执行flutter pub get拉取最新依赖包。

3. 完善Firebase初始化逻辑 #

在main函数中必须先完成Firebase初始化，确保适配桌面平台：

import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart'; // 由flutterfire configure自动生成

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

DefaultFirebaseOptions.currentPlatform会自动适配包括桌面在内的所有目标平台。

4. 清理缓存并重建项目 #

• 执行flutter clean清除项目缓存
• 针对对应桌面平台重新运行：
  • Windows：flutter run -d windows
  • macOS：flutter run -d macos
  • Linux：flutter run -d linux

5. 数据模型代码优化（可选） #

你的fromJson方法未处理Firestore文档ID（doc.data()不会包含文档ID），建议调整：

ResidentData.fromJson(Map<String, dynamic> json, {String? docId}) {
  id = docId ?? json['id']; // 优先使用传入的文档ID
  name = json['name'];
  type = json['type'];
  number = json['number'];
  timeIn = json['time_in'];
}

对应的Stream获取代码同步调整：

Stream<List<ResidentData>> readResidentData() {
  return FirebaseFirestore.instance
      .collection('user_data')
      .snapshots()
      .map((snapshot) => snapshot.docs
          .map((doc) => ResidentData.fromJson(doc.data(), docId: doc.id))
          .toList());
}

完成以上步骤后，桌面端即可正常从Firebase Firestore获取数据。

内容的提问来源于stack exchange，提问作者The Hung Bui