Flutter Web编译时如何忽略不支持的BackgroundIsolate代码？

问题重现 #

在macOS、Android平台正常运行的Background Isolate代码，执行flutter run -d chrome编译Web时出现以下编译错误：

Error: Member not found:
'BackgroundIsolateBinaryMessenger.ensureInitialized'.
BackgroundIsolateBinaryMessenger.ensureInitialized(input.rootIsolateToken);
^^^^^^^^^^^^^^^^^

原因是Web平台不支持BackgroundIsolateBinaryMessenger API，且直接用if (!kIsWeb)包裹代码无效——因为Dart的if是运行时判断，编译器仍会解析分支内的代码，导致静态检查报错。

疑问解答 #

1. 这不是Flutter Bug：属于平台API差异，Web平台本身没有Background Isolate的相关实现，因此该API仅在原生平台（iOS、Android、macOS等）可用。
2. 无需自行封装BackgroundIsolateBinaryMessenger：通过Dart的编译时条件导入即可解决，无需额外封装。
3. 标记if为const无效：kIsWeb本质是运行时变量，即使加const，静态检查仍会解析分支内的代码，无法避免报错。

解决方案：编译时条件导入 #

通过拆分平台代码+条件导入，让编译器在Web平台直接跳过不兼容的API代码：

1. 创建两个平台专属实现文件：

   • 非Web平台（isolate_setup_io.dart）：

     import 'package:flutter/services.dart';
     
     void setupBackgroundIsolate(RootIsolateToken token) {
       BackgroundIsolateBinaryMessenger.ensureInitialized(token);
     }
     

   • Web平台（isolate_setup_web.dart）：

     // Web平台无需初始化BackgroundIsolateBinaryMessenger，空实现即可
     void setupBackgroundIsolate(RootIsolateToken token) {}
     

2. 在主代码文件中条件导入：

   // 根据平台自动选择导入文件
   import 'isolate_setup_io.dart' if (dart.library.html) 'isolate_setup_web.dart';
   
   // 调用初始化方法，无需额外判断
   setupBackgroundIsolate(input.rootIsolateToken);
   

这样编译时，Web平台会直接导入空实现的文件，完全不会接触到BackgroundIsolateBinaryMessenger相关代码，彻底避免编译错误。

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