Flutter Firebase推送通知：后台/终止状态点击消息无法跳转问题

你的问题核心在于消息交互监听的初始化时机太晚：setupInteractMessage是在聊天首页调用的，但当应用处于后台或终止状态时，点击通知启动应用后，首先加载的是启动页，此时聊天首页还未初始化，导致getInitialMessage和onMessageOpenedApp的监听根本没有被执行，自然无法触发跳转逻辑。

具体修改方案 #

1. 全局NavigatorKey配置

首先在main.dart中定义一个全局的NavigatorKey，用于在无页面上下文的情况下完成导航操作：

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
  runApp(const MyApp());
}

@pragma('vm:entry-point')
Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
}

2. 移消息监听至APP启动初期

将消息交互的初始化逻辑移到MyApp的initState中，确保应用一启动就完成监听配置：

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    _setupMessageInteractions();
  }

  Future<void> _setupMessageInteractions() async {
    // 处理应用终止状态下点击通知的场景
    RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();
    if (initialMessage != null) {
      _handleNotificationNavigation(initialMessage);
    }

    // 处理应用后台状态下点击通知的场景
    FirebaseMessaging.onMessageOpenedApp.listen(_handleNotificationNavigation);
  }

  void _handleNotificationNavigation(RemoteMessage message) {
    if (message.data['type'] == 'msg') {
      // 通过全局NavigatorKey完成跳转
      navigatorKey.currentState?.pushNamedAndRemoveUntil(
        MyHome.routeName,
        (Route<dynamic> route) => false,
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      initialRoute: '/splash', // 你的启动页路由
      routes: {
        '/splash': (context) => const SplashScreen(),
        MyHome.routeName: (context) => const MyHome(),
        // 其他页面路由配置
      },
    );
  }
}

关键说明 #

• 全局NavigatorKey：解决了应用启动初期没有页面上下文无法导航的问题，允许我们在APP初始化阶段触发页面跳转。
• 监听时机提前：将_setupMessageInteractions放在MyApp的initState中，确保无论应用是冷启动还是后台唤醒，都能立即捕获通知点击事件。
• 移除原聊天首页的setupInteractMessage：避免重复监听，同时彻底解决初始化时机过晚的问题。

额外注意事项 #

• 确保推送消息的payload中包含type: 'msg'的data字段，否则跳转逻辑不会触发。
• 后台消息处理函数_firebaseMessagingBackgroundHandler无需处理导航，它运行在独立的隔离环境中，无法访问Flutter UI上下文。
• 测试终止状态跳转时，需完全退出应用（划掉应用进程），而非仅后台挂起。

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