Flutter接收Firebase后台通知时启动前台服务实现类WhatsApp通话功能

问题根因 #

Firebase Messaging的后台消息回调backgroundNotificationHandler运行在独立的Flutter隔离（Isolate）进程，和应用主进程完全分离，不存在共享的BuildContext，也无法直接调用依赖主进程上下文的UI操作、前台服务API。应用前台运行时消息回调走主进程，所以逻辑正常，后台/杀进程状态回调走独立隔离进程，就会出现无法获取上下文的报错。

解决方案 #

1. 跨隔离进程通信处理应用后台存活场景 #

如果应用只是最小化没有被系统杀死，可通过IsolateNameServer实现后台隔离进程和主进程的通信，把消息转发到主进程处理逻辑，无需在后台回调里直接操作上下文：

// 主进程 main.dart 初始化阶段注册通信端口
import 'dart:isolate';
import 'package:firebase_messaging/firebase_messaging.dart';

const String bgMessagePort = 'bg_message_transfer_port';
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  // 注册端口供后台隔离进程查找
  ReceivePort receivePort = ReceivePort();
  IsolateNameServer.registerPortWithName(receivePort.sendPort, bgMessagePort);
  // 监听后台回调转发过来的通话消息
  receivePort.listen((data) {
    RemoteMessage msg = data as RemoteMessage;
    // 主进程存在有效上下文，可正常执行弹框、启动前台服务、唤起通话页面等操作
    handleIncomingCall(msg);
  });
  FirebaseMessaging.onBackgroundMessage(backgroundNotificationHandler);
  runApp(const MyApp());
}

后台回调逻辑修改为：

@pragma('vm:entry-point')
Future<void> backgroundNotificationHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  // 查找主进程注册的通信端口
  SendPort? mainPort = IsolateNameServer.lookupPortByName(bgMessagePort);
  if (mainPort != null) {
    // 主进程存活，转发消息到主进程处理
    mainPort.send(message);
    return;
  }
  // 主进程已被杀死，调用原生侧逻辑处理
  await _channel.invokeMethod('showCallNotification', message.data);
}

2. 杀进程场景原生侧处理 #

当应用被完全杀死后，主进程端口不存在，需要在原生层直接处理通话通知：

• 安卓端：使用ApplicationContext（而非Activity Context）启动前台服务、发送高优先级通知，无需依赖Flutter侧的上下文。需提前在AndroidManifest.xml注册对应权限：

<!-- 通话前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL" />
<!-- 通知权限 -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- 后台弹出界面权限（可选，用于直接唤起通话页面） -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

原生侧创建优先级为IMPORTANCE_HIGH的通知通道，添加接听、拒接操作按钮，绑定点击事件的PendingIntent即可实现系统级通话通知提醒。

• iOS端：需搭配PushKit的VoIP推送实现后台/杀进程状态的通话唤起，普通APNs推送无法满足即时通话的触发要求。

3. 厂商权限适配 #

国内小米、华为、OPPO等厂商均有自定义的后台权限限制，需要引导用户手动开启「自启动」「后台弹出界面」「允许通知」等权限，才能确保杀进程状态下通话通知正常展示。

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