如何用GoRouter和Riverpod解决Flutter登出状态下路由访问限制问题？

核心思路是在重定向逻辑中添加登出状态允许访问的路由白名单，仅当用户访问白名单外的路由时才触发重定向到登录页，白名单内的页面（如注册、忘记密码）则正常放行。

步骤1：定义登出状态的路由白名单 #

先把所有允许未登录用户访问的路由路径整理成列表：

const List<String> unAuthenticatedRoutes = [
  '/login',
  '/signup',
  '/forgot-password',
];

步骤2：修改GoRouter的重定向逻辑 #

在GoRouter的redirect回调中，结合Riverpod的认证状态和当前访问的路由路径做针对性判断：

final goRouterProvider = Provider<GoRouter>((ref) {
  final authState = ref.watch(authStateProvider);
  
  return GoRouter(
    initialLocation: '/login',
    refreshListenable: authState, // 监听认证状态变化，自动触发重定向
    redirect: (context, state) {
      final currentLocation = state.location;
      
      switch (authState.state) {
        case AuthStateEnum.loggedIn:
          // 已登录状态下，若当前在未授权页面，重定向到首页
          if (unAuthenticatedRoutes.contains(currentLocation)) {
            return '/home';
          }
          return null; // 无需重定向
        case AuthStateEnum.needVerification:
          // 需要验证邮箱时，强制跳转到验证页（除非已经在验证页）
          if (currentLocation != '/verify-email') {
            return '/verify-email';
          }
          return null;
        case AuthStateEnum.loggedOut:
          // 未登录状态下，仅访问非白名单路由时才重定向到登录页
          if (!unAuthenticatedRoutes.contains(currentLocation)) {
            return '/login';
          }
          return null; // 白名单内路由直接放行
      }
    },
    routes: [
      GoRoute(
        path: '/login',
        builder: (context, state) => const LogInScreen(),
      ),
      GoRoute(
        path: '/signup',
        builder: (context, state) => const SignUpScreen(),
      ),
      GoRoute(
        path: '/forgot-password',
        builder: (context, state) => const ForgotPasswordScreen(),
      ),
      GoRoute(
        path: '/home',
        builder: (context, state) => const HomeScreen(),
      ),
      GoRoute(
        path: '/verify-email',
        builder: (context, state) => const VerifyEmailScreen(),
      ),
    ],
  );
});

关键细节说明 #

• 路由匹配精度：如果你的路由是嵌套结构（比如/signup/step1），可以把判断逻辑改成currentLocation.startsWith('/signup')，确保整个注册流程的子路由都能正常访问。
• refreshListenable：通过将authState设置为refreshListenable，当认证状态变化时，GoRouter会自动重新执行重定向逻辑，保证路由状态和认证状态同步。
• 避免无限重定向：每个状态分支里都要判断当前是否已经在目标页面，比如needVerification状态下，若已经在/verify-email就返回null，防止循环重定向。

异步状态处理（可选） #

如果你的authStateProvider是异步Provider（比如FutureProvider），需要处理加载状态，避免过早触发重定向：

final authStateProvider = FutureProvider<AuthStateEnum>((ref) async {
  // 从本地存储或后端获取认证状态的逻辑
});

// 在redirect中处理异步状态
redirect: (context, state) {
  final authStateAsync = ref.watch(authStateProvider);
  return authStateAsync.when(
    data: (authState) {
      // 上述状态判断逻辑
    },
    loading: () => null, // 加载时不执行重定向
    error: (_, __) => '/login', // 状态获取失败时跳转到登录页
  );
}

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