Flutter应用关闭后onSelectNotification无法获取FCM通知payload
问题本质
你遇到的onSelectNotification在应用杀死场景下完全不触发、拿不到payload的问题,是旧版本firebase_messaging和flutter_local_notifications的机制特性叠加导致的,不是代码逻辑遗漏:
- 如果FCM推送的消息携带
notification字段,当应用处于后台/杀死状态时,会由Android系统直接接管通知展示流程,完全绕开你写的所有自定义代码。这种情况下根本不会触发你注册的_firebaseMessagingBackgroundHandler,也不会调用flutterLocalNotificationsPlugin.show()去把payload和通知绑定。点击系统直接展示的通知拉起应用时,flutter_local_notifications根本感知不到这个通知的存在,所以onSelectNotification永远不会执行。 - 你虽然写了
getInitialMessage的监听,但没有打通这个回调对应的业务逻辑,同时初始化顺序有问题,导致冷启动下的通知点击事件根本捕获不到。
具体修复步骤
调整服务端推送格式,从根源匹配现有逻辑
如果要继续走自己用flutter_local_notifications展示通知的流程,服务端推送时不要携带notification字段,所有需要的通知标题、内容、自定义参数都放到data字段里。原因:只有不带
notification字段的FCM消息,才会在后台/杀死状态下走你注册的onBackgroundMessage回调,让你能手动调用showNotification把payload绑定到本地通知上。如果服务端没法修改推送格式,就直接跳过flutter_local_notifications的通道,用FCM自带的冷启动入口拿数据即可。修正初始化顺序,补全冷启动事件捕获逻辑
把flutterLocalNotificationsPlugin.initialize的调用放到initializeFCMNotifications方法的最开头,在所有FCM逻辑注册之前完成初始化,避免丢失冷启动时的通知点击事件。同时两个冷启动入口都要监听:// 原有FCM冷启动逻辑保留(拿系统展示通知的点击数据) await FirebaseMessaging.instance .getInitialMessage() .then((RemoteMessage? message) { if (message != null) { debugPrint('FCM冷启动点击消息数据: ${message.data.toString()}'); // 在此处添加页面跳转逻辑 } }); // 新增本地通知冷启动监听(拿自定义展示通知的点击数据) await flutterLocalNotificationsPlugin .getNotificationAppLaunchDetails() .then((details) { if (details?.didNotificationLaunchApp == true && details?.payload != null) { debugPrint('本地通知冷启动点击payload: ${details!.payload}'); // 在此处添加页面跳转逻辑 } });补全后台消息处理器的必要初始化
你的全局后台隔离处理器_firebaseMessagingBackgroundHandler里注释掉了Firebase.initializeApp(),这会导致后台/杀死状态下收到消息时,回调根本无法正常执行,自然不会触发showNotification。修正为:Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async { // 后台隔离环境下必须先初始化Firebase,否则回调无法执行 await Firebase.initializeApp(); final dynamic data = message.data; print('Data in background : ${data.toString()}'); NotificationHandler.showNotification(data); }解决通知通道ID不匹配、硬编码Payload的问题
你定义了全局的high_importance_channel通知通道,但在showNotification方法里用的是1234的通道ID,也没有在应用启动时把通道注册到Android系统中,会导致通知展示异常、点击回调丢失;同时你把payload硬编码成了固定字符串,就算回调正常触发,也拿不到对应通知的真实业务数据。需要:- 在
initializeFCMNotifications开头添加通道注册逻辑:final androidPlugin = flutterLocalNotificationsPlugin .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>(); await androidPlugin?.createNotificationChannel(channel); - 把
showNotification里的通道ID从1234改成你定义的channel.id,保持全局通道ID一致。 - 把硬编码的payload改成序列化后的真实业务数据:
// 导入dart:convert库使用jsonEncode await flutterLocalNotificationsPlugin.show( 0, data['title'], data['message'], platformChannelSpecifics, payload: jsonEncode(data), );
- 在
注意版本已知问题
你当前使用的firebase_messaging: ^9.1.1、flutter_local_notifications: ^5.0.0+1的版本组合,本身存在冷启动下通知点击回调丢失的已知bug。如果调整完上述逻辑还是不生效,可以在小版本范围内升级依赖(比如升级到firebase_messaging:9.2.0、flutter_local_notifications:5.0.1+4),不要跨大版本升级,避免引入新的适配问题。
内容的提问来源于stack exchange,提问作者Ahmet Bugra Ozcan

