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的通知将要展示的回调,在系统弹窗触发前拿到消息内容做解码处理,再决定通知的展示内容
- Android端:自定义继承
关键注意事项
- 绝对不要试图在Dart层修改系统已经自动弹出的通知:系统弹通知是原生层的行为,等Dart层拿到消息回调的时候,通知已经展示完成,拦截时机已经错过了
- 如果业务上必须通过FCM控制台发带
notification字段的推送,只能在原生层重写系统默认的通知接收逻辑,才能拿到前置的消息内容做解码,Dart层完全没有干预的入口 - 解码逻辑可以根据业务复杂度选择放在原生层或者Dart层,只要能在通知展示执行前完成处理即可
内容的提问来源于stack exchange,提问作者user3377896
相关产品推荐
相关产品推荐

