Flutter集成FCM与本地通知:应用关闭休眠时无法接收推送通知
应用退出/休眠后FCM通知无法接收的排查与解决步骤
基础配置漏项排查
- 补全AndroidManifest.xml的FCM强制声明配置
当前使用的firebase_messaging: ^7.0.3属于早期版本,不会自动完成系统层的服务注册,必须手动在Manifest的<application>节点下补充对应配置,否则应用被完全杀死后,系统进程无法将收到的FCM消息路由到应用,直接造成消息拦截:
关键提醒:如果未配置一致的默认通知渠道,Android 8.0以上系统会直接丢弃FCM推送的通知,不会触发任何弹窗。<service android:name="com.google.firebase.messaging.FirebaseMessagingService" android:exported="false"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service> <!-- 配置FCM默认通知渠道,需和本地通知使用的渠道ID完全一致 --> <meta-data android:name="com.google.firebase.messaging.default_notification_channel_id" android:value="it.wytex.vibeland_pro_app" /> - 补全token更新监听逻辑
当前代码仅在首次初始化时拉取一次FCM token并存储到Firestore,未实现onTokenRefresh回调监听。当系统轮换token、用户清除应用数据、卸载重装场景下,存储在Firestore的旧token会失效,导致云函数推送的目标设备是不存在的无效token,自然无法收到消息。需在registerNotification方法中补充对应监听:firebaseMessaging.onTokenRefresh.listen((newToken) { FirebaseFirestore.instance .collection('Consultant') .doc(firebaseUser.uid) .update({'deviceToken': newToken}); }); - 调整云函数的推送payload结构
当前云函数仅携带纯notification字段的payload,在应用休眠/被杀场景下,这类payload在国产定制ROM的后台查杀策略中极易被拦截。需补充data字段并显式声明高优先级,才能兼容系统在应用退出状态下的消息路由:const payload = { notification: { title: name, body: subject, sound: "default", click_action: "FLUTTER_NOTIFICATION_CLICK", }, // 补充data字段,支撑应用退出后的消息路由 data: { title: name, body: subject, click_action: "FLUTTER_NOTIFICATION_CLICK", }, android: { priority: "high", notification: { channelId: "it.wytex.vibeland_pro_app" } } }; return fcm.sendToDevice(token, payload);
场景适配逻辑修正
- 不要依赖业务页面的initState做通知初始化
当前代码将configLocalNotification()、通知注册逻辑放在业务页面的initState中,当应用被完全关闭后,如果启动流程没有跳转到这个页面,所有通知相关的初始化逻辑都不会执行。需将所有通知初始化、权限申请、token监听的逻辑,全部移到应用根组件的初始化流程中,保证Dart引擎一启动就完成全量通知能力配置,不依赖业务页面加载。 - 修正应用被杀状态下的通知点击逻辑
当前在firebaseMessaging.configure()中写的页面跳转逻辑,仅在应用进程存活时生效。应用被杀后Dart引擎未初始化,这类逻辑根本无法执行。需在AndroidManifest中为NotificationsScreen对应的Activity配置匹配FLUTTER_NOTIFICATION_CLICK的intent-filter,让系统直接在通知被点击时拉起对应页面,不需要依赖Dart层的代码运行。 - 移除冗余的连续弹窗逻辑
当前showNotification方法中,先弹出带实际消息内容的通知,紧接着弹出一条固定文案的通用通知,这类连续弹窗行为会被系统判定为骚扰推送,在应用后台/被杀场景下直接被拦截。需删除固定文案的冗余弹窗逻辑,仅根据实际消息内容弹出单条通知。
老版本已知问题的临时规避
当前使用的firebase_messaging: ^7.0.3、flutter_local_notifications: ^4.0.1版本组合,本身存在后台消息处理的能力缺失:两个老版本插件未提供可靠的后台消息回调入口,当应用被杀时,Dart层根本无法收到FCM消息,也就无法触发本地通知。在不升级版本的前提下,临时解决方案是完全依赖系统FCM的原生通知展示能力——不要在代码里主动做本地通知的弹出逻辑,让系统根据配置的通知渠道、payload结构直接展示通知,绕过Dart层未初始化的问题。
另外需注意,国内网络环境下FCM的长连接稳定性较差,应用被杀后长连接断开是无法接收消息的重要原因,仅靠代码配置无法完全解决所有场景的触达问题。
内容的提问来源于stack exchange,提问作者Emanuel Developer
相关产品推荐
相关产品推荐

