You need to enable JavaScript to run this app. Flutter集成FCM与本地通知:应用关闭休眠时无法接收推送通知
优惠活动
大模型
产品
解决方案
定价
更多

Flutter集成FCM与本地通知:应用关闭休眠时无法接收推送通知

应用退出/休眠后FCM通知无法接收的排查与解决步骤

基础配置漏项排查

  • 补全AndroidManifest.xml的FCM强制声明配置
    当前使用的firebase_messaging: ^7.0.3属于早期版本,不会自动完成系统层的服务注册,必须手动在Manifest的<application>节点下补充对应配置,否则应用被完全杀死后,系统进程无法将收到的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" />
    
    关键提醒:如果未配置一致的默认通知渠道,Android 8.0以上系统会直接丢弃FCM推送的通知,不会触发任何弹窗。
  • 补全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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.31 13:24:02