Flutter中GoRouter如何实现类似pushNamedAndRemoveUntil的效果？

我在Flutter应用中使用go_router: ^9.0.3进行导航。进入navigationWidget页面后，点击设备返回键或网页返回按钮时会回到登录或OTP页面，希望进入该页面后清除登录和OTP页面的页面栈，但GoRouter中没有pushNamedAndRemoveUntil方法，该如何实现？

当前路由配置代码如下：

static final GoRouter router = GoRouter(
    initialLocation: '/',
      routes: [
        GoRoute(
          name: AppRouteConstant.splashRoute,
          path: '/',
          pageBuilder: (context, state) {
            return MaterialPage(
                child: SplashWidget(
              isTokenValid: AuthService.authenticated,
              key: UniqueKey(),
            ));
          },
        ),
        GoRoute(
          name: AppRouteConstant.loginRoute,
          path: '/login',
          builder: (context, state) {
            return Login_Screen(
              key: UniqueKey(),
            );
          },
        ),
        GoRoute(
          name: AppRouteConstant.welcomeRoute,
          path: '/welcome',
          pageBuilder: (context, state) {
            return const MaterialPage(child: WelcomeScreen());
          },
        ),
        GoRoute(
          name: AppRouteConstant.mfaLoginWithOtpRoute,
          path: '/loginWithOtp',
          pageBuilder: (context, state) {
            return const MaterialPage(child: MFALoginScreen());
          },
        ),
        GoRoute(
          name: AppRouteConstant.navigationWidgetRoute,
          path: '/navigationWidget',
          pageBuilder: (context, state) {
            return const MaterialPage(child: NavigationWidget());
          },
        ),
        GoRoute(
          name: AppRouteConstant.profileRoute,
          path: '/profile',
          pageBuilder: (context, state) {
            return const MaterialPage(child: UserProfileScreen());
          },
        ),
        // GoRoute(
        //   name: AppRouteConstant.homeRoute,
        //   path: '/home',
        //   pageBuilder: (context, state) {
        //     return const MaterialPage(child: HomeScreen());
        //   },
        // ),
        GoRoute(
          name: AppRouteConstant.tvReplayRoute,
          path: '/tvReplay',
          pageBuilder: (context, state) {
            return MaterialPage(
                child: TVReplay(
                    filterdata: state.queryParameters['filterData'],
                    flag: bool.parse(state.queryParameters['flag']!)));
          },
        ),
        GoRoute(
          name: AppRouteConstant.movieDetailsRoute,
          path: '/movieDetails',
          pageBuilder: (context, state) {
            return const MaterialPage(child: MovieDetails());
          },
        ),
        GoRoute(
          name: AppRouteConstant.commonSearchRoute,
          path: '/search',
          pageBuilder: (context, state) {
            List<Movie> genres = state.extra as List<Movie>? ?? [];
            return MaterialPage(
                child: Search(
              movies: genres,
            ));
          },
        ),
        GoRoute(
          name: AppRouteConstant.selectionListRoute,
          path: '/selectionList',
          pageBuilder: (context, state) {
            return MaterialPage(
                child: selectionList(
                    filterData: state.queryParameters["filterData"]));
          },
        ),
        GoRoute(
          name: AppRouteConstant.selectedSeriesScreenRoute,
          path: '/selectedSeries',
          pageBuilder: (context, state) {
            return MaterialPage(child: SelectedSeriesScreen());
          },
        ),
        GoRoute(
          name: AppRouteConstant.locationRoute,
          path: '/location',
          pageBuilder: (context, state) {
            return const MaterialPage(child: LocationPage());
          },
        ),
        GoRoute(
          name: AppRouteConstant.bluetoothRoute,
          path: '/bluetooth',
          pageBuilder: (context, state) {
            return const MaterialPage(child: Bluetooth_Screen());
          },
        ),
        GoRoute(
          name: AppRouteConstant.sliderRoute,
          path: '/slider',
          pageBuilder: (context, state) {
            return const MaterialPage(child: CircularSlider());
          },
        ),
        GoRoute(
          name: AppRouteConstant.customUIRoute,
          path: '/customUI',
          pageBuilder: (context, state) {
            return const MaterialPage(child: CustomUi());
          },
        ),

      ],
      errorPageBuilder: (context, state) {
        return MaterialPage(
            child: Scaffold(
          body: Text(state.error.toString()),
        ));
      },
      redirect: (context, state) {
        print("state is ${state.location}");
        if (AuthService.authenticated && state.location == '/login') {
          return '/navigationWidget';
        } else {
          return null;
        }
      });

登录进入navigationWidget页面后，点击设备默认返回键或网页返回按钮时，会导航回登录页面。

GoRouter虽然没有pushNamedAndRemoveUntil，但可以通过以下几种方式实现清除登录/OTP页面栈的需求：

方法1：用replace替换整个路由栈 #

登录成功后，直接使用replace方法将navigationWidget设为路由栈的唯一页面，彻底清除之前的登录、OTP页面：

// 登录成功后的跳转代码
GoRouter.of(context).replace('/navigationWidget');

方法2：优化redirect逻辑自动清除栈 #

修改现有redirect配置，当已认证用户访问登录/OTP页面时，用replace跳转而非普通路径返回，避免保留旧路由：

redirect: (context, state) {
  print("state is ${state.location}");
  if (AuthService.authenticated) {
    if (state.location == '/login' || state.location == '/loginWithOtp') {
      GoRouter.of(context).replace('/navigationWidget');
      return null;
    }
    return null;
  } else {
    if (state.location != '/' && state.location != '/login' && state.location != '/loginWithOtp') {
      return '/login';
    }
    return null;
  }
}

方法3：在navigationWidget中拦截返回事件 #

如果需要完全控制返回行为，可在navigationWidget中用WillPopScope拦截设备返回键，阻止返回到登录页面：

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

  @override
  State<NavigationWidget> createState() => _NavigationWidgetState();
}

class _NavigationWidgetState extends State<NavigationWidget> {
  @override
  Widget build(BuildContext context) {
    return WillPopScope(
      onWillPop: () async {
        // 返回false表示不允许返回，可根据需求改为退出应用等逻辑
        return false;
      },
      child: Scaffold(
        // 页面内容
      ),
    );
  }
}

方法4：用pushReplacementNamed逐页替换 #

如果是从登录/OTP页面直接跳转，使用pushReplacementNamed替换当前页面，避免旧页面留在栈中：

// 登录页面跳转代码
context.pushReplacementNamed(AppRouteConstant.navigationWidgetRoute);

// OTP页面跳转代码同理
context.pushReplacementNamed(AppRouteConstant.navigationWidgetRoute);

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