点击FCM通知启动已关闭Flutter应用时，GoRouter页面跳转异常

问题根源 #

应用完全关闭时出现的路由异常，核心原因是冷启动阶段getInitialMessage回调执行过早，GoRouter尚未完成初始化，连续的goNamed+pushNamed操作导致路由栈混乱：

• 两次导航几乎同时执行，GoRouter来不及处理第一个goNamed就执行pushNamed，可能导致reviewDetail直接成为路由栈的根页面，返回按钮失效；
• 若GoRouter初始化未完成，还可能出现路由未注册的"页面未找到"错误。

解决方案 #

方案1：使用嵌套路由，一次导航到位

将reviewDetail配置为reviews的子路由，直接通过goNamed导航到详情页，GoRouter会自动将父路由reviews加入栈中，确保栈结构为reviews -> reviewDetail，返回按钮正常工作。

路由配置示例：

enum RouteNames {
  reviews,
  reviewDetail,
}

final goRouterProvider = Provider<GoRouter>((ref) {
  return GoRouter(
    initialLocation: '/',
    routes: [
      GoRoute(
        path: '/',
        builder: (context, state) => const HomePage(),
      ),
      GoRoute(
        name: RouteNames.reviews.name,
        path: '/reviews',
        builder: (context, state) => const ReviewsPage(),
        // 配置子路由
        routes: [
          GoRoute(
            name: RouteNames.reviewDetail.name,
            path: 'review-detail',
            builder: (context, state) {
              final message = state.extra as RemoteMessage;
              return ReviewDetailPage(message: message);
            },
          ),
        ],
      ),
    ],
  );
});

处理初始消息代码：

ref.read(messagingProvider).getInitialMessage().then((RemoteMessage? message) {
  if (message == null) return;
  // 直接导航到详情页，自动加载父路由reviews
  ref.read(goRouterProvider).goNamed(
    RouteNames.reviewDetail.name,
    extra: message,
  );
});

方案2：延迟第二个导航操作（非嵌套路由场景）

如果无法使用嵌套路由，通过Future.delayed让第一个goNamed操作完成后，再执行pushNamed，避免路由栈冲突：

ref.read(messagingProvider).getInitialMessage().then((RemoteMessage? message) {
  if (message == null) return;
  final router = ref.read(goRouterProvider);
  router.goNamed(RouteNames.reviews.name);
  // 延迟100ms执行push，确保第一个导航完成
  Future.delayed(const Duration(milliseconds: 100), () {
    router.pushNamed(RouteNames.reviewDetail.name, extra: message);
  });
});

额外检查项

• 确保Android Manifest/iOS Info.plist中FCM通知的Intent Filter配置正确，点击通知能正常唤醒应用并传递消息参数；
• 验证RemoteMessage的参数格式，避免因extra传递异常导致页面加载失败。

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