Flutter FCM应用长时间闲置后通知无法送达的问题求助

这种FCM长连接在设备闲置后断开、数据消息无法送达的情况很常见，核心原因是系统电池优化策略回收了FCM后台连接，以下是针对iOS和Android的具体解决方案：

Android端优化 #

• 调整消息配置：在云函数的消息参数中添加delivery_receipt_requested: true，FCM会返回消息是否成功递送到设备的回执，可在云函数中监听回执确认状态；同时保持android.priority: "high"，高优先级消息能绕过部分系统后台限制。
• 规避电池优化：引导用户将应用从系统电池优化列表中排除（路径：设置→电池→电池优化→找到应用→设为不优化），尤其是小米、华为等国产ROM，这类系统对后台进程限制更严格。
• 定期保活连接：用WorkManager创建低频率定期任务（如每2-3小时一次），任务中调用FirebaseMessaging.instance.getToken()触发FCM连接刷新，避免连接被系统回收。

iOS端优化 #

• 修正APNs配置：在apns.payload.aps中添加mutable-content: true，让应用在后台接收消息时触发回调；同时确保Info.plist中UIBackgroundModes包含remote-notification，且用户已开启应用的后台App刷新权限。
• BackgroundTasks保活：使用iOS的BackgroundTasks框架，定期执行轻量任务刷新FCM连接，避免长时间闲置导致连接断开。

通用优化 #

• 云函数重试机制：在云函数中添加消息重试逻辑，若发送后未收到送达回执，间隔一段时间（如5分钟）后重新发送，直到确认送达或达到重试上限。
• 应用内连接检测：Flutter应用启动时检查FCM连接状态，若异常则调用FirebaseMessaging.instance.deleteToken()后重新获取令牌，强制刷新连接。

可从设备端、Firebase控制台、云函数三个层面获取FCM的处理日志：

设备端日志 #

Android #

• 使用ADB命令过滤FCM相关日志：

  adb logcat -s FirebaseMessaging FirebaseInstanceId FirebaseMessagingService
  

  该命令会输出FCM的连接状态、消息接收、令牌刷新等详细日志，可查看消息是否到达设备。

iOS #

• 在Xcode的Console面板中过滤关键词FCM或APNs，查看APNs推送接收记录和FCM处理日志；也可在设备设置→隐私→分析与改进→分析数据中，查找含FCM或PushKit的日志文件。

Firebase控制台日志 #

• 进入Firebase控制台的Cloud Messaging页面，点击报告标签查看消息送达率、延迟等统计数据；在消息历史记录中可查看单条消息的状态（已发送、已送达、失败等）。
• 开启FCM高级报告功能，获取从云函数到FCM服务器、再到设备的全链路流转数据。

云函数与回执日志 #

• 在云函数消息配置中添加delivery_receipt_requested: true，FCM会将送达回执发送到指定Firestore集合（需提前配置），监听该集合可获取每条消息的最终送达状态。
• 云函数中admin.messaging().send()返回的response包含消息ID，可与Firebase控制台的消息历史记录关联，追踪消息流转路径。

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