FCM中FirebaseMessaging.onMessageOpenedApp无法触发问题求助

以下是针对该问题的核心排查方向及解决建议：

1. 监听注册时机错误 #

FirebaseMessaging.onMessageOpenedApp.listen必须在Firebase初始化完成后、应用生命周期早期注册，不能延迟到某个页面内部才初始化。如果点击通知时监听还未建立，就无法触发回调。

• 建议将监听移至根Widget的initState或main函数中：

  @override
  void initState() {
    super.initState();
    // 确保Firebase已完成初始化
    FirebaseMessaging.onMessageOpenedApp.listen((message) {
      toast(message.data.toString());
      var route = message.data["route"];
      Navigator.pushNamed(context, route);
    });
  }
  

2. 通知Payload格式不符合要求 #

• 若通过Firebase控制台或后台接口发送通知，需确保：
  • Android端需设置click_action: FLUTTER_NOTIFICATION_CLICK，否则系统无法将点击事件传递给Flutter层。示例Payload：

    {
      "notification": {
        "title": "测试标题",
        "body": "测试内容"
      },
      "data": {
        "route": "/detail"
      },
      "android": {
        "notification": {
          "click_action": "FLUTTER_NOTIFICATION_CLICK"
        }
      }
    }
    

  • 需同时包含notification和data字段（纯数据消息需额外处理），避免因Payload缺失导致回调不触发。

3. 本地通知服务的干扰 #

你使用了LocalNotificationService.display展示通知，若该服务是基于flutter_local_notifications等第三方库实现，点击本地通知的事件由第三方库的回调处理，而非FCM的onMessageOpenedApp。

• 需在本地通知的初始化逻辑中添加点击回调，处理页面跳转：

  await flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onSelectNotification: (payload) async {
      if (payload != null) {
        Navigator.pushNamed(context, payload);
      }
    },
  );
  

4. 混淆了应用启动状态 #

onMessageOpenedApp仅在应用处于后台/前台挂起状态时点击通知才会触发；若应用完全被杀死（进程已结束），点击通知会触发getInitialMessage而非该监听。

• 测试时需确保应用处于后台（按Home键退出而非强制关闭），再点击通知验证。

5. 依赖版本问题 #

旧版本的firebase_messaging可能存在该回调不触发的已知Bug，建议升级至最新稳定版：
修改pubspec.yaml：

firebase_messaging: ^latest_version

执行flutter pub get后重新运行应用。

6. 平台特定配置缺失 #

• Android：检查AndroidManifest.xml中是否正确声明FirebaseMessagingService，且主Activity的intent-filter包含正确的action配置。
• iOS：检查Info.plist中FirebaseAppDelegateProxyEnabled是否设为YES，若手动集成需确保AppDelegate正确将通知点击事件传递给Flutter端。

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