Flutter获取非空NavigatorKey及后台通知跳转问题求助

问题根源 #

使用MaterialApp.router集成go_router时，你定义的全局GlobalKey<NavigatorState>并未关联到go_router的导航栈，导致currentContext始终为null；同时后台消息处理线程无法直接操作导航，依赖延迟执行的方式也不可靠。

具体修复步骤 #

1. 给GoRouter绑定全局navigatorKey #

确保go_router实例使用全局的navigatorKey，让导航栈能被全局访问：

// 全局定义navigatorKey
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

// 初始化GoRouter时绑定key
final GoRouter router = GoRouter(
  navigatorKey: navigatorKey,
  routes: [
    // 你的其他路由定义
    GoRoute(
      path: '/notification/message',
      builder: (context, state) => NotificationMessagePage(
        payload: state.extra as String,
      ),
    ),
  ],
);

2. 替换通知启动的跳转逻辑 #

去掉Future.delayed，改用addPostFrameCallback确保Widget树初始化完成后再跳转，同时直接使用go_router的push方法：

final NotificationAppLaunchDetails? notificationAppLaunchDetails =
    await flutterLocalNotificationsPlugin.getNotificationAppLaunchDetails();
if (notificationAppLaunchDetails?.didNotificationLaunchApp ?? false) {
  String payload =
      notificationAppLaunchDetails!.notificationResponse?.payload ?? "";
  print('Got a message in terminated');
  // 替换原延迟执行代码
  WidgetsBinding.instance.addPostFrameCallback((_) {
    router.push('/notification/message', extra: payload);
  });
}

3. 配置本地通知的点击回调 #

在本地通知初始化时，添加onDidReceiveNotificationResponse回调，直接用go_router处理跳转，覆盖后台/前台通知点击场景：

// 修改PushNotification.localNotiInit方法
static Future<void> localNotiInit() async {
  const AndroidInitializationSettings androidSettings =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  final DarwinInitializationSettings iosSettings = DarwinInitializationSettings(
    onDidReceiveLocalNotification: (id, title, body, payload) async {},
  );
  final InitializationSettings initSettings = InitializationSettings(
    android: androidSettings,
    iOS: iosSettings,
  );

  await flutterLocalNotificationsPlugin.initialize(
    initSettings,
    onDidReceiveNotificationResponse: (NotificationResponse response) async {
      if (response.payload != null && response.payload!.isNotEmpty) {
        // 直接用go_router跳转
        router.push('/notification/message', extra: response.payload);
      }
    },
  );
}

4. 后台消息处理注意事项 #

_firebaseMessagingBackgroundHandler运行在隔离线程，不能直接执行导航操作，只需负责显示通知即可，导航逻辑交给本地通知的点击回调处理（即上面的onDidReceiveNotificationResponse），你的现有这部分代码无需修改。

关键提醒 #

• 确保router实例在runApp前已完成初始化，避免跳转时路由未就绪。
• 不要混用普通Navigator和go_router的导航方法，统一使用go_router的API处理页面跳转。

内容的提问来源于stack exchange，提问作者Flower.K