Flutter Dart在Isolate中调用DynamicLibrary报错求助

错误原因 #

你遇到的Invalid argument(s): Illegal argument in isolate message: (object is a DynamicLibrary)错误，本质是Dart Isolate之间只能传递可序列化的对象，而DynamicLibrary（FFI库实例）和Pointer这类资源对象不属于可序列化范畴，无法直接跨Isolate共享。每个Isolate拥有独立的内存空间，不能直接访问其他Isolate中的Native资源实例。

解决方案 #

下面给出两种可行的解决思路，根据你的业务场景选择：

方案1：在目标Isolate内部重新加载FFI库并初始化 #

既然不能共享DynamicLibrary，那就让Isolate自己完成库加载、状态初始化和方法调用。修改代码如下：

首先调整Hub类，让它支持在任意Isolate中初始化：

class Hub {
  static final Hub _singleton = Hub._internal();

  late hub lib;
  late Pointer<hub_state_s> state;

  factory Hub() {
    return _singleton;
  }

  Hub._internal();

  // 假设这是你原来的初始化逻辑，加载库并创建状态
  Future<int> init() async {
    // 替换成你实际的库加载方式（比如打包后的路径）
    lib = hub(DynamicLibrary.open('libhub.so'));
    state = lib.hub_init();
    return 0; // 返回初始化结果码
  }

  // 封装Isolate内要执行的完整逻辑
  static Future<void> runInIsolate() async {
    final hub = Hub();
    final initResult = await hub.init();
    if (initResult == 0) {
      print("running isolate");
      hub.lib.hub_start(hub.state);
    }
  }
}

然后修改start方法，让Isolate执行封装好的逻辑：

start() async {
  // 如果主线程不需要使用Hub实例，可以直接让Isolate完成所有流程
  await Isolate.run(Hub.runInIsolate);

  // 如果你需要主线程先初始化，再让Isolate单独执行调用（注意：此时Isolate仍需自己重新加载库）
  // final hub = Hub();
  // final initResult = await hub.init();
  // if (initResult == 0) {
  //   await Isolate.run(Hub.runInIsolate);
  // }
}

方案2：利用Native层全局状态（需线程安全） #

如果你的Native库使用了全局状态，且hub_start方法依赖的是全局状态而非传入的state指针，那么可以在主线程初始化后，让Isolate重新加载库，直接调用方法。但要注意：必须确保Native方法是线程安全的（比如用互斥锁保护共享资源）。

示例代码：

start() async {
  final hub = Hub();
  final initResult = await hub.init();
  if (initResult == 0) {
    await Isolate.run(() {
      // Isolate内重新加载库
      final isolateLib = hub(DynamicLibrary.open('libhub.so'));
      print("running isolate");
      // 直接调用方法，依赖Native全局状态
      isolateLib.hub_start(null);
    });
  }
}

关键注意事项 #

• 每个Isolate加载的FFI库是独立实例，Native资源（如内存分配）需要在各自Isolate内管理，避免跨Isolate释放导致崩溃。
• 如果涉及多Isolate调用Native方法，必须保证Native代码的线程安全性，否则会出现数据竞争或崩溃。
• 永远不要尝试跨Isolate传递DynamicLibrary、Pointer、NativeFunction这类对象，它们只能在创建它们的Isolate中有效。

内容的提问来源于stack exchange，提问作者Kęstutis Ramulionis