Firebase后台通知更新UI时SendPort为空的问题求助

Firebase 后台消息处理器运行在独立的后台隔离区（Isolate），和主UI隔离区完全分离。IsolateNameServer的端口注册仅在当前隔离区内有效，后台隔离区无法读取主UI隔离区注册的端口，因此lookupPortByName返回null，调用send时触发错误。

方案一：使用SharedPreferences传递通知内容（简单可靠） #

通过SharedPreferences临时存储后台通知内容，主UI隔离区定时检查或监听存储变化来更新UI。

1. 修改后台消息处理器，将通知内容存入SharedPreferences：

@pragma('vm:entry-point')
Future<void> handleBackgroundNotification(RemoteMessage remoteMessage) async {
  try {
    final prefs = await SharedPreferences.getInstance();
    // 存储通知内容
    await prefs.setString('latest_background_notification', remoteMessage.notification?.body ?? '');
    // 存储时间戳，避免重复处理相同通知
    await prefs.setInt('notification_timestamp', DateTime.now().millisecondsSinceEpoch);
  } catch (e) {
    log(e.toString());
    throw e;
  }
}

2. 在主UI页面监听SharedPreferences变化并更新UI：

import 'package:shared_preferences/shared_preferences.dart';

// 页面类内
late SharedPreferences _prefs;
StreamSubscription? _notificationListener;
int? _lastProcessedTimestamp;

@override
void initState() {
  super.initState();
  _initNotificationListener();
  FirebaseMessaging.onBackgroundMessage(handleBackgroundNotification);
}

void _initNotificationListener() async {
  _prefs = await SharedPreferences.getInstance();
  // 初始检查一次已有通知
  _checkAndUpdateNotification();
  // 定时轮询检查通知变化（可根据需求调整轮询间隔）
  _notificationListener = Stream.periodic(const Duration(seconds: 1)).listen((_) {
    _checkAndUpdateNotification();
  });
}

void _checkAndUpdateNotification() {
  final latestContent = _prefs.getString('latest_background_notification');
  final currentTimestamp = _prefs.getInt('notification_timestamp');
  
  if (latestContent != null && currentTimestamp != null) {
    // 仅处理未处理过的新通知
    if (currentTimestamp > (_lastProcessedTimestamp ?? 0)) {
      _lastProcessedTimestamp = currentTimestamp;
      // 这里执行UI更新逻辑
      log('收到后台通知：$latestContent');
      setState(() {
        // 比如更新页面状态变量，显示通知内容
      });
    }
  }
}

@override
void dispose() {
  // 取消监听，避免内存泄漏
  _notificationListener?.cancel();
  super.dispose();
}

方案二：使用flutter_isolate实现跨隔离区端口通信（实时性更高） #

借助flutter_isolate库实现跨隔离区的端口共享，直接传递通知内容到主UI隔离区。

1. 添加依赖到pubspec.yaml：

dependencies:
  flutter_isolate: ^2.0.0 # 请使用最新版本

2. 在主UI隔离区注册共享端口：

import 'package:flutter_isolate/flutter_isolate.dart';

@override
void initState() {
  super.initState();
  _initSharedPort();
  FirebaseMessaging.onBackgroundMessage(handleBackgroundNotification);
}

void _initSharedPort() async {
  await FlutterIsolate.spawn((SendPort sendPort) {
    final receivePort = ReceivePort();
    // 注册跨隔离区共享端口
    FlutterIsolate.registerPortWithName(receivePort.sendPort, 'port_firebase');
    receivePort.listen((data) {
      // 收到后台通知，更新UI
      log('收到后台通知：$data');
      setState(() {
        // 执行UI更新逻辑
      });
    });
  });
}

3. 修改后台消息处理器，通过共享端口发送数据：

@pragma('vm:entry-point')
Future<void> handleBackgroundNotification(RemoteMessage remoteMessage) async {
  try {
    final SendPort? sendPort = await FlutterIsolate.lookupPortByName('port_firebase');
    if (sendPort != null) {
      sendPort.send(remoteMessage.notification?.body ?? '');
    }
  } catch (e) {
    log(e.toString());
    throw e;
  }
}

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