Flutter中FirebaseMessaging后台消息回调调用MethodChannel报错问题

问题原因 #

Firebase的_firebaseMessagingBackgroundHandler后台消息处理函数运行在独立的后台Isolate中，而Flutter的MethodChannel插件注册仅存在于主Isolate。后台Isolate无法访问主Isolate的插件注册信息，因此调用invokeMethod时会抛出MissingPluginException。

解决方案：通过主Isolate转发原生方法调用 #

后台Isolate无法直接调用原生方法，我们可以通过Isolate间通信，让主Isolate代为执行原生调用：

1. 在主Isolate中设置通信端口 #

在main函数中创建ReceivePort，注册端口并监听后台Isolate的指令：

SendPort? _mainIsolateSendPort;

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // 创建接收端口，用于监听后台Isolate的消息
  final receivePort = ReceivePort();
  IsolateNameServer.registerPortWithName(receivePort.sendPort, 'main_isolate_port');

  // 处理后台Isolate发送的指令
  receivePort.listen((message) {
    if (message == 'trigger_wakeup') {
      wakeupscreen(); // 在主Isolate中执行原生方法调用
    }
  });

  // 注册后台消息处理函数
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);

  runApp(const MyApp());
}

2. 修改后台消息处理函数，发送指令到主Isolate #

在后台回调中，通过注册的端口名称获取主Isolate的SendPort，发送执行指令：

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  print("Handling a background message: ${message.messageId}");
  await Firebase.initializeApp();

  // 获取主Isolate的通信端口
  final mainSendPort = IsolateNameServer.lookupPortByName('main_isolate_port');
  // 发送唤醒屏幕的指令
  mainSendPort?.send('trigger_wakeup');
}

3. 保留原有的原生方法调用函数 #

wakeupscreen函数无需修改，它在主Isolate中执行，能正常访问MethodChannel：

void wakeupscreen() async {
  try {
    const platform = MethodChannel('flutter_native');
    await platform.invokeMethod('wakeupscreen');
  } on PlatformException catch (e) {
    print("Failed to invoke the method: '${e.message}'.");
  }
}

额外注意事项 #

• Android端：确保原生的wakeupscreen方法支持在后台线程执行（可通过Handler切换到主线程，或保证方法线程安全）。
• iOS端：需提前申请唤醒屏幕的相关权限，且注意iOS后台执行的限制，部分操作可能需要特定的后台模式权限。

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