FlutterFire后台isolate单例通信异常问题咨询（VoIP推送挂断场景）

Flutter的Isolate之间不共享内存，所有静态变量、全局单例在不同Isolate中都是独立的副本。FlutterFire的后台消息处理逻辑运行在独立于主UI的专用Isolate中，你只要在后台handler中调用SingletonGlobal()就会在这个独立内存空间里创建新的单例实例，这是Isolate的固有特性，和单例的实现逻辑无关。

你之前的方案逻辑方向是对的，但是错误地在后台Isolate中访问了单例实例，同时单例的监听逻辑也存在语法错误。

1. 重写SingletonGlobal单例 #

仅允许在主Isolate中初始化单例，提前注册跨Isolate通信的端口，监听其他Isolate发送的消息并转交给内部流：

import 'dart:isolate';
import 'package:flutter/foundation.dart';

// 纯数据类，仅包含可序列化的字段，支持跨Isolate传递
class HangUpEvent {
  final String callId;
  HangUpEvent(this.callId);
}

class SingletonGlobal {
  static SingletonGlobal? _instance;
  final _receivePort = ReceivePort();
  final hangUpStreamController = StreamController<HangUpEvent>.broadcast();

  // 仅允许在主Isolate调用该工厂方法
  factory SingletonGlobal() {
    if(_instance == null) {
      assert(Isolate.current.debugName == 'main', 'SingletonGlobal只能在主Isolate初始化');
      _instance = SingletonGlobal._internal();
    }
    return _instance!;
  }

  SingletonGlobal._internal() {
    if (kDebugMode) print('SingletonGlobal#internal 仅在主Isolate初始化一次');
    // 注册端口到全局名称服务器，跨Isolate可查询
    IsolateNameServer.registerPortWithName(_receivePort.sendPort, 'global_singleton_port');
    // 监听其他Isolate发送的消息，转成流事件同步给UI层
    _receivePort.listen((message) {
      if (message is HangUpEvent) {
        hangUpStreamController.add(message);
      }
    });
  }

  // 销毁逻辑，避免内存泄漏
  void dispose() {
    _receivePort.close();
    IsolateNameServer.removePortNameMapping('global_singleton_port');
    hangUpStreamController.close();
    _instance = null;
  }
}

2. 主Isolate提前初始化单例 #

在APP启动时的主Isolate中提前初始化单例，完成端口注册：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 主Isolate初始化单例，注册跨Isolate通信端口
  SingletonGlobal();
  runApp(const MyApp());
}

3. 修正后台消息处理逻辑 #

后台Isolate中不要访问任何单例实例，直接查询全局注册的端口，向主Isolate发送挂断事件即可：

Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  // 不要在后台Isolate中执行初始化单例的逻辑

  if (message.data['type'] == 'hangup') {
    // 查询主Isolate注册的通信端口
    final sendPort = IsolateNameServer.lookupPortByName('global_singleton_port');
    if (sendPort != null) {
      // 端口存在说明主Isolate仍在运行，直接发送挂断事件
      final hangUpEvent = HangUpEvent(message.data['callId'] ?? '');
      sendPort.send(hangUpEvent);
    }
    // 端口不存在说明主Isolate已销毁，通话界面自然不存在，无需处理
  }
}

4. CallScreen监听逻辑保持不变 #

正常监听单例的流即可，注意在dispose时取消流订阅避免内存泄漏：

class CallScreen extends StatefulWidget {
  // ...
  @override
  void initState() {
    super.initState();
    // 监听挂断事件关闭UI
    SingletonGlobal().hangUpStreamController.stream.listen((event) => closeCallUI(event));
  }
}

• HangUpEvent必须是纯数据类，不能包含闭包、BuildContext、原生句柄等不可序列化的对象，否则无法跨Isolate传递
• 如果APP被系统杀死，主Isolate销毁后端口会自动失效，不会出现无效触发的问题

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