Firebase_messaging: 应用被杀时onMessageOpenedApp.listen()无效的解决办法

在Firebase Messaging的新版本里，getInitialMessage()就是专门用来处理应用被杀状态下点击通知启动的API，完美替代废弃的onLaunch。

具体实现步骤 #

1. 在应用初始化阶段调用getInitialMessage()
   可以放在main()函数里，确保Firebase初始化完成后调用，它会返回启动应用的那条通知消息（如果是通过点击通知启动的）：

   void main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
   
     // 处理被杀状态下点击通知启动的情况
     final RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();
     if (initialMessage != null) {
       // 提取payload并跳转指定页面
       _navigateToTargetPage(initialMessage.data);
     }
   
     runApp(const MyApp());
   }
   

2. 统一处理跳转逻辑
   把后台点击通知（onMessageOpenedApp）和被杀启动的跳转逻辑抽成公共方法，避免重复代码：

   void _navigateToTargetPage(Map<String, dynamic> payload) {
     // 示例：从payload中获取目标路由
     final String targetRoute = payload['target_route'] ?? '/';
     // 使用全局导航key跳转（避免context问题）
     _navigatorKey.currentState?.pushNamed(targetRoute);
   }
   
   // 提前定义全局导航key，在MaterialApp中配置
   final GlobalKey<NavigatorState> _navigatorKey = GlobalKey<NavigatorState>();
   

3. 配合后台场景的监听
   加上onMessageOpenedApp的监听，覆盖后台运行时点击通知的场景，形成完整的处理链路：

   void _setupFirebaseListeners() {
     // 后台运行时点击通知
     FirebaseMessaging.onMessageOpenedApp.listen((RemoteMessage message) {
       _navigateToTargetPage(message.data);
     });
   
     // 前台收到通知（可选，按需处理本地弹窗）
     FirebaseMessaging.onMessage.listen((RemoteMessage message) {
       // 这里可以调用本地通知插件显示通知
     });
   }
   

关键注意点 #

• 服务器发送的消息必须包含数据字段（纯通知消息可能无法传递自定义payload到客户端），确保payload里有你需要的页面标识/路由信息。
• 全局导航key是必要的：因为在main()里调用getInitialMessage()时，App还没完全构建，直接用Navigator.of(context)会报错，所以要在MaterialApp中设置navigatorKey: _navigatorKey。

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