Flutter点击FCM推送调用Navigator跳转页面报错如何解决

报错根因 #

你当前的setupInteractedMessage调用时机太早，使用的上下文位于Navigator组件的上层，无法获取到导航实例。应用在前台运行时context可能已经刷新可以找到Navigator，但后台恢复时回调触发过早，就会出现找不到Navigator的报错。

修复方案（推荐使用全局NavigatorKey方案，通用性最强） #

步骤1：定义全局导航Key #

在全局位置（比如main.dart文件顶部）定义导航Key：

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

步骤2：绑定Key到MaterialApp #

将定义好的key赋值给MaterialApp的navigatorKey属性：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      // 保留你原有配置：routes、theme、home等
    );
  }
}

步骤3：修改导航逻辑 #

调整_handleMessage方法，使用全局Key获取导航实例进行路由跳转，不再依赖局部context：

void _handleMessage(RemoteMessage message) {
  navigatorKey.currentState?.pushNamed("/shop", arguments: message.data["id"]);
  return;
}

可选优化：兼容冷启动场景 #

如果应用完全终止状态下点击通知打开，需要确保导航实例初始化完成后再执行跳转，可以给初始消息的处理加渲染完成回调：

Future<void> setupInteractedMessage() async {
    RemoteMessage? initialMessage = await FirebaseMessaging.instance.getInitialMessage();

    if (initialMessage != null) {
      // 等待页面第一帧渲染完成，保证Navigator已初始化
      WidgetsBinding.instance.addPostFrameCallback((_) {
        _handleMessage(initialMessage);
      });
    }

    FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
}

替代方案 #

如果你不想用全局Key，也可以把setupInteractedMessage的调用从初始化位置移动到MaterialApp的子组件中（比如首页的initState生命周期里），此时子组件的context已经是Navigator的后代，可以正常调用Navigator.pushNamed。

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