Flutter FCM中onBackgroundMessage与onMessageOpenedApp触发及冗余问题咨询

核心回调触发规则（你的理解基本准确，补充边界细节） #

• onBackgroundMessage
  触发节点是消息送达设备，和用户是否点击通知完全无关，覆盖两种状态：应用退到后台进程存活、应用进程完全终止。该回调运行在独立isolate，和主UI进程内存不互通，仅支持执行短耗时的轻量操作（比如本地存储、简单数据计算），无法直接操作UI、访问主进程内存变量。
  注意：仅携带通知字段、无data字段的纯通知推送，由系统托管通知展示，不会触发该回调。
• onMessageOpenedApp
  触发节点是用户点击通知，仅覆盖一种场景：应用进程存活、处于后台状态时，用户点击系统展示的FCM通知将应用拉回前台。该回调运行在主UI isolate，可以直接执行页面跳转、UI更新这类操作。

常见问题解答 #

同时使用两个回调是否会产生逻辑冗余？ #

不会。两个回调负责的是推送链路里完全独立的两个节点，没有重叠：

• 只要是「无论用户是否交互，消息送达就要执行」的逻辑（比如你现在做的未读通知本地存储、离线消息计数预同步），放在onBackgroundMessage里实现
• 只要是「用户点击通知才需要执行」的交互逻辑（比如跳转指定内容页、上报通知点击埋点），放在onMessageOpenedApp里实现

应用关闭状态下用户点击通知，两个回调都会触发吗？ #

会分阶段触发，但不会在同一时间点重复执行逻辑：

1. 第一阶段：推送消息送达设备时，onBackgroundMessage会率先在独立isolate中触发，执行你预设的消息存储等逻辑，此时用户还未产生点击行为。
2. 第二阶段：用户点击通知冷启动应用时，onMessageOpenedApp不会触发，该场景下的通知携带数据需要通过FirebaseMessaging.instance.getInitialMessage()获取，该方法仅在冷启动时返回一次点击对应的消息对象，取值后自动清空，不会重复返回。

是否需要在点击通知的回调中校验消息是否已被onBackgroundMessage处理？ #

需要做幂等校验，避免逻辑重复执行：
只要是携带data字段的推送，消息送达时onBackgroundMessage已经提前将通知存入本地，后续用户点击通知触发回调时，如果直接重复执行存储、计数、跳转逻辑，会出现本地通知重复、计数错误、重复跳转页面的问题。
你可以直接用FCM自带的唯一messageId作为去重标识：

1. 在onBackgroundMessage中存储通知时，将messageId作为主键存入本地
2. 在onMessageOpenedApp回调、getInitialMessage()拿到点击消息时，先根据messageId查询本地是否已有对应记录
   • 若已存在：跳过存储、计数类逻辑，仅执行点击后的交互逻辑
   • 若不存在（比如纯通知推送未触发onBackgroundMessage的场景）：先补存通知记录，再执行后续交互逻辑

额外提示：你当前使用flutter_local_notifications做本地通知展示时，可以直接将FCM的messageId哈希后作为本地通知的ID，避免同一消息重复弹出通知栏提醒。

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