Flutter中Isolate感知Widget初始化及BLE扫描不阻塞UI方案咨询

错误信息 #

E/flutter ( 5598): [ERROR:flutter/runtime/dart_isolate.cc(1097)] Unhandled exception:
E/flutter ( 5598): 'package:flutter/src/services/platform_channel.dart': Failed assertion: line 542 pos 7: '_binaryMessenger != null || BindingBase.debugBindingType() != null': Cannot set the method call handler before the binary messenger has been initialized. This happens when you call setMethodCallHandler() before the WidgetsFlutterBinding has been initialized. You can fix this by either calling WidgetsFlutterBinding.ensureInitialized() before this or by passing a custom BinaryMessenger instance to MethodChannel().
E/flutter ( 5598): #0      _AssertionError._doThrowNew (dart:core-patch/errors_patch.dart:51:61)
E/flutter ( 5598): #1      _AssertionError._throwNew (dart:core-patch/errors_patch.dart:40:5)
E/flutter ( 5598): #2      MethodChannel.setMethodCallHandler (package:flutter/src/services/platform_channel.dart:542:7)
E/flutter ( 5598): #3      FlutterBluePlus._initFlutterBluePlus (package:flutter_blue_plus/src/flutter_blue_plus.dart:395:20)
E/flutter ( 5598): #4      FlutterBluePlus._invokeMethod (package:flutter_blue_plus/src/flutter_blue_plus.dart:557:7)
E/flutter ( 5598): <asynchronous suspension>
E/flutter ( 5598): #5      FlutterBluePlus.adapterState (package:flutter_blue_plus/src/flutter_blue_plus.dart:134:20)
E/flutter ( 5598): <asynchronous suspension>
E/flutter ( 5598): #6      _ForwardingStreamSubscription._handleData (dart:async/stream_pipe.dart:152:3)
E/flutter ( 5598): <asynchronous suspension>

相关代码 #

UI按钮触发代码 #

ElevatedButton(
              onPressed: () {
                //isolate scan test
                ReceivePort receivePort = ReceivePort();
                receivePort.listen((message) { 
                  log('GOT MESSAGE $message');
                  
                  receivePort.close();
                });
                
                Isolate.spawn(bluetoothScanning, receivePort.sendPort);
              },
              child: const Text('Scan for Devices'),
            ),

Isolate执行函数 #

void bluetoothScanning(SendPort msg) async{
  Set<DeviceList>? device = await BluetoothScreen().scan();
  return msg.send(device);
}

BluetoothScreen类初始化 #

BluetoothScreen1() {
      var subscription = FlutterBluePlus.onScanResults.listen((results)  {
        if (results.isNotEmpty) {
          ScanResult r = results.last; // the most recently found device
          deviceList.add(
            DeviceList('${r.device.remoteId}', r.advertisementData.advName,r.device));
        }
      }, onError: (e) => log('Error $e'));
      FlutterBluePlus.cancelWhenScanComplete(subscription);
}

扫描方法 #

Future<Set<DeviceList>> scan() async {
    log('BLE SCAN ENTERED');
    await FlutterBluePlus.adapterState
        .where((val) => val == BluetoothAdapterState.on)
        .first;

    await FlutterBluePlus.startScan(timeout: const Duration(seconds: 5));

    await FlutterBluePlus.isScanning.where((val) => val == false).first;

    return deviceList;
}

解决方案 #

核心原因 #

每个Isolate都是独立的执行环境，主线程初始化的WidgetsFlutterBinding不会自动同步到其他Isolate。FlutterBluePlus依赖MethodChannel与原生平台通信，而MethodChannel需要依赖Binding提供的BinaryMessenger，因此在Isolate中直接调用FlutterBluePlus会触发初始化错误。

推荐方案：扫描在主线程，数据处理在Isolate #

FlutterBluePlus的扫描操作本身是异步非阻塞的，不会卡住UI。真正可能耗时的是扫描结果的过滤、解析等逻辑，把这部分放到Isolate即可：

1. 修改按钮点击逻辑，拆分扫描与数据处理：

ElevatedButton(
  onPressed: () async {
    ReceivePort receivePort = ReceivePort();
    receivePort.listen((processedDevices) { 
      log('处理后的设备列表: $processedDevices');
      receivePort.close();
    });
    
    // 启动Isolate用于处理扫描结果
    Isolate.spawn(processScanResults, receivePort.sendPort);
    
    // 主线程执行扫描（异步不阻塞UI）
    Set<DeviceList> rawDevices = await BluetoothScreen().scan();
    // 将原始结果发送给Isolate处理
    receivePort.sendPort.send(rawDevices);
  },
  child: const Text('Scan for Devices'),
),

2. 编写Isolate中的数据处理函数：

void processScanResults(SendPort mainSendPort) async {
  ReceivePort isolateReceivePort = ReceivePort();
  // 把Isolate的通信端口传给主线程
  mainSendPort.send(isolateReceivePort.sendPort);
  
  // 接收主线程传来的原始扫描结果
  var rawDevices = await isolateReceivePort.first as Set<DeviceList>;
  
  // 执行耗时处理：比如过滤空名称设备、排序等
  Set<DeviceList> processedDevices = rawDevices
      .where((device) => device.name.isNotEmpty)
      .toSet();
  
  // 将处理结果传回主线程
  mainSendPort.send(processedDevices);
  isolateReceivePort.close();
}

备选方案：在Isolate中初始化Binding（不推荐） #

如果一定要在Isolate中执行扫描，需要在Isolate内部初始化Binding，为MethodChannel提供必要的环境：

void bluetoothScanning(SendPort msg) async{
  // 初始化ServicesBinding（比WidgetsFlutterBinding更轻量，满足MethodChannel需求）
  ServicesBinding.ensureInitialized();
  Set<DeviceList>? device = await BluetoothScreen().scan();
  msg.send(device);
}

注意：此方式可能导致FlutterBluePlus的状态在多Isolate中不一致，存在潜在问题，仅作为临时解决手段。

Isolate与主线程通信说明 #

• 主线程通过Isolate.spawn传递自身的SendPort给Isolate，Isolate可通过该端口回传数据。
• 若需主线程主动通知Isolate（比如告知UI已初始化完成），Isolate需创建自己的ReceivePort，并将其SendPort传给主线程，主线程保存后即可发送指令：

// Isolate侧代码
void isolateFunction(SendPort mainSendPort) {
  ReceivePort isolatePort = ReceivePort();
  // 把Isolate的通信端口发给主线程
  mainSendPort.send(isolatePort.sendPort);
  
  // 监听主线程指令
  isolatePort.listen((message) {
    if (message == 'ui_ready') {
      // 执行扫描或其他任务
    }
  });
}

// 主线程侧代码
SendPort? isolateSendPort;

void startIsolate() {
  ReceivePort mainPort = ReceivePort();
  Isolate.spawn(isolateFunction, mainPort.sendPort);
  
  mainPort.listen((message) {
    if (message is SendPort) {
      isolateSendPort = message;
      // UI初始化完成后通知Isolate
      isolateSendPort?.send('ui_ready');
    } else {
      // 处理Isolate传回的结果
    }
  });
}

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