You need to enable JavaScript to run this app. Flutter如何拦截FCM通知并在系统展示前完成自定义处理?
优惠活动
大模型
产品
解决方案
定价
更多

Flutter如何拦截FCM通知并在系统展示前完成自定义处理?

FCM通知前置拦截解码实现方案

首先要明确最容易踩的核心误区:很多人写的拦截逻辑不生效,本质是没搞清楚FCM的回调触发规则——只要推送请求里带了notification节点,应用在后台/被杀状态下,系统会直接消费消息弹出通知,根本不会把消息内容传到Dart层,所有写在Dart层的拦截逻辑都不会被触发。

前置调整要求

所有需要自定义解码、拦截展示的推送,发送时只把内容塞到data字段,不要携带notification字段,从根源上避免系统绕过你的逻辑直接弹通知。

分场景实现拦截解码

应用前台运行状态

该场景下系统不会自动展示通知,直接在现有onMessage回调里处理即可:

_firebaseMessaging.configure(
  onMessage: (Map<String, dynamic> message) async {
    // 从data字段取编码后的标题、正文
    final encodedTitle = message['data']['push_title'] ?? '';
    final encodedBody = message['data']['push_body'] ?? '';
    // 执行自定义解码(比如Base64解码、自定义对称解密等)
    final realTitle = decodeFunc(encodedTitle);
    final realBody = decodeFunc(encodedBody);
    // 用本地通知插件构建解码后的通知,替代系统默认弹窗
    await FlutterLocalNotificationsPlugin().show(
      DateTime.now().millisecondsSinceEpoch ~/ 1000,
      realTitle,
      realBody,
      const NotificationDetails(
        android: AndroidNotificationDetails('channel_id', '通知渠道名称'),
      ),
    );
  },
  // 其余原有回调保持不变
);

应用后台/被杀运行状态

该场景下纯data类型的消息不会自动弹通知,需要配合两层逻辑完成前置处理:

  • 给后台消息顶级函数myBackgroundMessageHandler加上入口注解,避免Release模式下被代码优化移除:
    @pragma('vm:entry-point')
    Future<void> myBackgroundMessageHandler(RemoteMessage message) async {
      // 同样在这里取data字段的编码内容做解码
      final encodedTitle = message.data['push_title'] ?? '';
      final encodedBody = message.data['push_body'] ?? '';
      final realTitle = decodeFunc(encodedTitle);
      final realBody = decodeFunc(encodedBody);
      // 解码完成后再调用本地通知能力展示
    }
    
  • 原生层配置FCM消息服务拦截,替代系统默认的自动通知逻辑:
    • Android端:自定义继承FirebaseMessagingService的服务,重写onMessageReceived方法,不管应用处于什么状态,收到消息后第一时间拿到data内容做解码,再手动调用通知API展示,完全接管系统默认的通知展示流程
    • iOS端:实现UNUserNotificationCenterDelegate的通知将要展示的回调,在系统弹窗触发前拿到消息内容做解码处理,再决定通知的展示内容

关键注意事项

  • 绝对不要试图在Dart层修改系统已经自动弹出的通知:系统弹通知是原生层的行为,等Dart层拿到消息回调的时候,通知已经展示完成,拦截时机已经错过了
  • 如果业务上必须通过FCM控制台发带notification字段的推送,只能在原生层重写系统默认的通知接收逻辑,才能拿到前置的消息内容做解码,Dart层完全没有干预的入口
  • 解码逻辑可以根据业务复杂度选择放在原生层或者Dart层,只要能在通知展示执行前完成处理即可

内容的提问来源于stack exchange,提问作者user3377896

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 21:24:05