iOS端Flutter插件注册：解决Hive、path_provider在isolate中MissingPluginException问题

出现该异常的核心原因是Flutter原生插件默认仅注册到主Isolate关联的平台通道，后台自定义Isolate默认没有绑定插件的原生实现调用通道。

优先尝试Dart侧绑定方案（无需修改原生代码） #

Flutter 2.12及以上版本提供了官方的后台Isolate平台通道绑定能力，无需手动注册原生插件即可解决问题，操作步骤如下：

• 主Isolate启动前先初始化Flutter绑定，获取RootIsolateToken并传入后台Isolate
• 后台Isolate执行逻辑前先绑定平台通道，即可正常调用两个插件的API
  代码示例：

import 'dart:isolate';
import 'package:flutter/services.dart';
import 'package:hive/hive.dart';
import 'package:path_provider/path_provider.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 获取主Isolate的平台绑定令牌
  final rootToken = RootIsolateToken.instance!;
  // 启动后台Isolate时传入令牌
  await Isolate.spawn(runBackgroundTask, rootToken);
}

void runBackgroundTask(RootIsolateToken token) async {
  // 后台Isolate绑定平台通道，继承主Isolate的插件注册信息
  BackgroundIsolateBinaryMessenger.ensureInitialized(token);
  
  // 此处可正常调用path_provider和Hive
  final appDocDir = await getApplicationDocumentsDirectory();
  Hive.init(appDocDir.path);
  // 后续Hive操作逻辑
}

如果上述方案无法解决问题，再尝试原生侧手动注册插件操作：

Android端手动注册插件 #

• 打开项目内app/src/main/kotlin/[你的应用包名]/MainActivity.kt文件
• 重写configureFlutterEngine方法，手动添加两个插件的注册逻辑：

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugins.pathprovider.PathProviderPlugin
import io.github.hivedb.HivePlugin

class MainActivity: FlutterActivity() {
  override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    flutterEngine.plugins.add(PathProviderPlugin())
    flutterEngine.plugins.add(HivePlugin())
  }
}

• 若使用Java编写MainActivity，将上述代码转换为对应Java语法即可。

iOS端手动注册插件 #

• 打开项目内ios/Runner/AppDelegate.swift文件
• 在didFinishLaunchingWithOptions方法中添加手动注册逻辑：

import UIKit
import Flutter
import path_provider_ios
import hive

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self.flutterEngine!)
    // 手动注册PathProvider插件
    PathProviderPlugin.register(with: self.flutterEngine!.registrar(forPlugin: "PathProviderPlugin")!)
    // 手动注册Hive插件
    HivePlugin.register(with: self.flutterEngine!.registrar(forPlugin: "HivePlugin")!)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

• 若使用Objective-C编写AppDelegate，将上述代码转换为对应OC语法即可。

验证生效 #

完成配置后执行flutter clean清除项目缓存，再重新编译运行即可。

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