从原生代码创建的Flutter isolate调用插件时出现MissingPluginException如何解决

问题根源 #

你遇到的MissingPluginException是因为原生侧创建的Flutter isolate对应的执行上下文，没有完成Flutter插件的方法通道绑定：主Isolate启动时会自动执行所有依赖插件的注册逻辑，而原生侧独立启动的后台Isolate默认没有走这个流程，所有方法通道调用都找不到对应实现。

具体实现步骤 #

Android原生侧修改 #

1. 你创建的用于跑后台Isolate的独立FlutterEngine实例，必须手动触发插件注册，代码如下：

// 初始化后台FlutterEngine
FlutterEngine backgroundEngine = new FlutterEngine(context);
// 调用自动生成的插件注册类，完成所有依赖插件的注册
GeneratedPluginRegistrant.registerWith(backgroundEngine);
// 加载你指定的Dart后台入口函数
backgroundEngine.getDartExecutor().executeDartEntrypoint(
    DartExecutor.DartEntrypoint.createDefault()
);

注：GeneratedPluginRegistrant是Flutter编译时自动生成的类，包含了你项目所有依赖的Flutter插件的注册逻辑，每个独立的FlutterEngine实例都需要单独执行一次注册。
2. 原生侧和Dart后台Isolate通信的MethodChannel，必须绑定当前后台Engine的BinaryMessenger：

MethodChannel backgroundChannel = new MethodChannel(
    backgroundEngine.getDartExecutor().getBinaryMessenger(),
    "你的后台通道名"
);

Dart侧修改 #

你指定的后台Isolate入口函数必须是顶层/静态函数，且入口第一行先初始化插件绑定：

// 后台Isolate入口，必须是顶层函数
void backgroundIsolateEntry() {
  // Flutter 2.12+ 用这个方法初始化插件注册绑定，替代旧的WidgetsFlutterBinding
  DartPluginRegistrant.ensureInitialized();
  // 后续你的业务逻辑，这里调用sqflite、package_info_plus等插件不会再报错
}

变通方案 #

如果部分插件本身不支持后台Isolate调用，可以用以下两种方案规避：

• 方案1：后台Isolate只处理纯Dart逻辑，所有需要调用插件的请求，通过SendPort发送到主Isolate执行，执行完成后再把结果回传给后台Isolate
• 方案2：原生侧直接实现对应插件的能力（比如直接用原生API操作SQLite、读取设备信息），处理完成后再把结果传递给Dart层

常见注意事项 #

• 如果开启了R8混淆，需要将GeneratedPluginRegistrant类加入混淆白名单，防止被优化移除
• 如果你用的Flutter版本低于2.12，可将DartPluginRegistrant.ensureInitialized()替换为WidgetsFlutterBinding.ensureInitialized()

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