Flutter应用通知触发导航异常问题求助

针对你遇到的三种状态下导航异常问题，逐一分析并给出修复步骤：

问题根源分析 #

1. 前台点击通知不跳转：selectNotification中传递的payload仅包含message.data，但dealWithMessage开头强制读取message.notification!，会触发空指针异常，导致后续导航代码无法执行；同时直接使用传入的context可能存在上下文无效的情况。
2. 应用终止时点击不跳转：getInitialMessage在应用启动初期调用，此时Widget树尚未完全初始化，导航上下文可能未就绪。
3. 后台跳转正常：onMessageOpenedApp触发时应用已处于活跃状态，上下文有效且消息数据完整，因此导航正常。

具体修复步骤 #

1. 重构dealWithMessage函数，移除无效的通知依赖 #

修改函数逻辑，优先处理导航逻辑，避免强制读取可能为空的notification字段：

void dealWithMessage(RemoteMessage? message) {
  if (message == null) return;
  
  // 优先处理导航逻辑
  if (message.data.isNotEmpty) {
    if (message.data['intent'] == 'comment') {
      var postSlug = message.data['post_slug'];
      // 使用全局导航Key替代传入的context（后续步骤实现）
      navigatorKey.currentState?.push(MaterialPageRoute(
          builder: (context) => PostDetailScreen(postSlug: postSlug)));
    }
    // 其他intent处理代码...
  }

  // 仅当存在通知内容时，再处理通知展示
  final notification = message.notification;
  final android = message.notification?.android;
  if (notification != null && android != null) {
    flutterLocalNotificationsPlugin.show(
        notification.hashCode,
        notification.title,
        notification.body,
        NotificationDetails(
          android: AndroidNotificationDetails(channel.id, channel.name,
              color: Colors.black,
              playSound: true,
              icon: '@mipmap/ic_launcher',
              importance: Importance.max,
              priority: Priority.high),
        ));
  }
}

2. 实现全局导航Key，避免上下文无效问题 #

在应用入口文件（如main.dart）定义全局导航Key：

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

// 在MaterialApp中配置该Key
MaterialApp(
  navigatorKey: navigatorKey,
  // 其他应用配置...
)

之后在notification_handler.dart中导入此Key，替代原有的Navigator.of(context)调用。

3. 修复selectNotification的消息构造逻辑 #

原代码仅用message.data构造RemoteMessage，导致字段缺失，修改为：

Future selectNotification(String? payload) async {
  if (payload != null) {
    Map<String, dynamic> data = jsonDecode(payload);
    RemoteMessage message = RemoteMessage(data: data);
    dealWithMessage(message);
  }
}

4. 处理应用终止状态下的导航延迟 #

修改getInitialMessage的处理逻辑，确保在Widget树初始化完成后执行导航：

FirebaseMessaging.instance.getInitialMessage().then((message) {
  if (message != null) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      dealWithMessage(message);
    });
  }
});

5. 简化onMessage监听逻辑 #

移除onMessage中重复的通知展示代码，直接调用dealWithMessage：

FirebaseMessaging.onMessage.listen((RemoteMessage message) {
  flutterLocalNotificationsPlugin.show(
      message.notification?.hashCode ?? 0,
      message.notification?.title,
      message.notification?.body,
      NotificationDetails(
        android: AndroidNotificationDetails(channel.id, channel.name,
            color: Colors.black,
            playSound: true,
            icon: '@mipmap/ic_launcher',
            importance: Importance.max,
            priority: Priority.high),
      ),
      payload: jsonEncode(message.data));
  dealWithMessage(message);
});

验证修复效果 #

• 前台状态：收到通知后点击，可正常跳转到PostDetailScreen
• 后台状态：保持原有正常跳转逻辑
• 终止状态：点击通知打开应用后，自动跳转到目标页面

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