Flutter集成Firebase Firestore遇平台线程通道消息错误

问题分析 #

这个错误是因为Firestore插件在非平台线程（主线程）发送了平台通道消息，违反了Flutter的线程规则。你尝试用Isolate解决是没用的，因为问题出在Firestore插件的回调线程绑定上，而非你的业务代码执行线程。

解决方案 #

1. 升级Firebase依赖到最新稳定版 #

旧版本的cloud_firestore插件存在线程调度的bug，优先升级pubspec.yaml中的相关依赖：

firebase_core: ^latest_version
cloud_firestore: ^latest_version

执行flutter pub upgrade完成升级，很多时候这个问题在新版本中已经被修复。

2. 确保Firestore操作在主线程执行 #

Firestore的实例初始化、Stream订阅必须在Flutter主线程（平台线程）完成。比如在Widget的initState方法中订阅Stream，而不是在后台任务或Isolate中：

@override
void initState() {
  super.initState();
  // 主线程中订阅Stream
  _countStream = YourFirestoreClass.getItemCountStream();
  _itemsStream = YourFirestoreClass.getItems();
}

3. 手动将Stream事件调度到主线程 #

如果升级依赖后问题仍存在，可以手动将Firestore Stream的事件切换到主线程。先导入scheduler包：

import 'package:flutter/scheduler.dart';

然后修改你的Stream函数，确保事件在主线程分发：

static Stream<int> getItemCountStream() {
  return _folderRef.snapshots().asyncMap((snapshot) {
    // 检查当前是否在主线程
    if (SchedulerBinding.instance.isSchedulerRunning) {
      return Future.value(snapshot.size);
    }
    // 调度到主线程后返回结果
    final completer = Completer<int>();
    SchedulerBinding.instance.addPostFrameCallback((_) {
      completer.complete(snapshot.size);
    });
    return completer.future;
  });
}

static Stream<List<ItemModel>> getItems() {
  return _folderRef.snapshots().asyncMap((snapshot) {
    final items = snapshot.docs.map((doc) => ItemModel.fromJson(doc.data())).toList();
    
    if (SchedulerBinding.instance.isSchedulerRunning) {
      return Future.value(items);
    }
    
    final completer = Completer<List<ItemModel>>();
    SchedulerBinding.instance.addPostFrameCallback((_) {
      completer.complete(items);
    });
    return completer.future;
  });
}

4. 禁止在Isolate中操作Firestore #

Isolate是独立的执行环境，Firestore插件内部依赖平台线程的通道通信，在Isolate中初始化Firestore或订阅其Stream会导致线程上下文不匹配，直接避开这种写法即可。

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