Flutter Windows桌面端操作Firestore时出现非平台线程通道消息报错

问题详情 #

把Flutter应用编译成Windows桌面版后，只要操作Firestore数据库就会弹出以下错误：

[ERROR:flutter/shell/common/shell.cc(1053)] The 'plugins.flutter.io/firebase_storage/taskEvent/{{id}}' channel sent a message from native to Flutter on a non-platform thread. Platform channel messages must be sent on the platform thread. Failure to do so may result in data loss or crashes, and must be fixed in the plugin or application code creating that channel.

这个问题只在Windows桌面端出现，从Flutter 3.2到3.27版本都存在，而且firebase_core及其他Firebase相关包的版本不影响问题触发。因为应用要兼容Web，所以没使用任何compute/isolates。

已尝试的解决步骤 #

• 升级Flutter并更新所有依赖包
• 查阅相关文档和社区讨论帖
• 用FlutterFire_cli规范初始化Firebase
• 修复Flutter Doctor检测出的所有问题

环境配置 #

Flutter Doctor检测结果：

[✓] Flutter (Channel stable, 3.27.1, on Microsoft Windows [Version 10.0.26100.2605]
[✓] Windows Version (Installed version of Windows is version 10 or higher)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Chrome - develop for the web
[✓] Visual Studio - develop Windows apps (Visual Studio Community 2022 17.12.3)
[✓] Android Studio (version 2024.1)
[✓] VS Code (version 1.96.2)
[✓] Connected device (3 available)
[✓] Network resources

• No issues found!

疑问 #

怀疑是CMake相关问题，但从没修改过CMake配置；用FlutterFire_cli给Firebase项目添加Windows平台后，打开Visual Studio时提示安装/修改CMake，但不确定这么做能不能解决问题，也不清楚项目是否需要Firebase SDK或CMake SDK。

可行解决思路 #

1. 完成Visual Studio的CMake组件安装：Windows平台的Firebase插件依赖CMake构建原生模块，按照提示安装或更新CMake组件，大概率能修复线程调度异常问题。
2. 强制Firestore操作在平台线程执行：虽然你没用到isolates，但Firebase原生插件内部可能在后台线程处理回调，试试用PlatformDispatcher把Firestore操作包裹起来，确保消息发送到平台线程：

   import 'dart:ui';
   
   void runOnPlatformThread(VoidCallback callback) {
     PlatformDispatcher.instance.invokeOnPlatformThread(callback);
   }
   
   // 使用示例
   runOnPlatformThread(() {
     FirebaseFirestore.instance.collection('your_collection').doc('your_doc').get();
   });
   

3. 锁定旧版Firebase插件：尝试把firebase_storage锁定到11.0.0左右的稳定版本，部分新版本可能引入了Windows线程处理的bug。
4. 检查Firebase初始化时机：确保Firebase.initializeApp在main函数的平台线程执行，代码示例：

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

5. 提交插件Bug反馈：如果以上方法都没用，这大概率是Firebase插件Windows平台的bug，直接去FlutterFire仓库提交issue，附上你的环境信息和复现步骤。

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