Flutter页面调用时统一检查JWT Token过期的实现方案咨询：是否必须在每个页面调用检查函数，或可仅在main.dart中配置？

嘿，完全没必要在每个页面里都塞一遍Token过期检查逻辑，那样既冗余又难维护。Flutter有好几种全局统一处理的方式，我给你分享几个常用且实用的：

1. 路由守卫（Route Guard） #

这是最直接的方式，利用Flutter路由系统的钩子，在每次页面跳转前统一检查Token状态。你可以通过MaterialApp的onGenerateRoute方法来实现，或者用go_router这类路由包的中间件功能。

举个基础的实现例子：

MaterialApp(
  onGenerateRoute: (RouteSettings settings) {
    // 全局检查Token是否过期
    bool isTokenExpired = _checkIfTokenExpired();
    
    // 如果Token过期且当前不是登录页，直接跳转到登录页
    if (isTokenExpired && settings.name != '/login') {
      return MaterialPageRoute(builder: (_) => const LoginPage());
    }

    // 正常处理其他路由跳转
    switch (settings.name) {
      case '/home':
        return MaterialPageRoute(builder: (_) => const HomePage());
      case '/profile':
        return MaterialPageRoute(builder: (_) => const ProfilePage());
      default:
        return MaterialPageRoute(builder: (_) => const NotFoundPage());
    }
  },
);

这样不管用户从哪个入口跳转页面，都会先经过Token检查，完全不用在各个页面里重复写逻辑。

2. 结合全局状态管理 #

如果你的项目已经在用状态管理工具（比如Provider、Riverpod、Bloc），可以把Token的状态和过期检查逻辑放到全局状态中，然后在根Widget监听状态变化，一旦检测到过期就自动导航到登录页。

比如用Riverpod的简单示例：

// 定义一个全局Provider来管理Token过期状态
final tokenExpiryProvider = StateProvider<bool>((ref) {
  // 初始化时检查Token状态
  return _checkIfTokenExpired();
});

// 在根Widget中监听状态
class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return ProviderScope(
      child: Consumer(
        builder: (context, ref, child) {
          final isTokenExpired = ref.watch(tokenExpiryProvider);
          
          // 用addPostFrameCallback避免BuildContext异常
          WidgetsBinding.instance.addPostFrameCallback((_) {
            if (isTokenExpired) {
              Navigator.pushReplacement(
                context,
                MaterialPageRoute(builder: (_) => const LoginPage()),
              );
            }
          });
          
          return child!;
        },
        child: const MaterialApp(
          home: HomePage(),
          routes: {/* 路由配置 */},
        ),
      ),
    );
  }
}

这种方式的好处是，Token状态变化时（比如用户主动退出、Token自动过期），能实时触发页面跳转，体验更流畅。

3. 封装全局导航工具类 #

如果你的项目跳转逻辑比较分散，可以封装一个全局的导航工具类，所有页面跳转都通过这个工具类来发起，在工具类里统一加入Token检查逻辑。

示例：

class NavigationService {
  static GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

  static Future<void> pushNamed(String routeName, {Object? arguments}) async {
    // 先检查Token
    if (_checkIfTokenExpired() && routeName != '/login') {
      navigatorKey.currentState?.pushReplacementNamed('/login');
      return;
    }
    // 正常跳转
    navigatorKey.currentState?.pushNamed(routeName, arguments: arguments);
  }

  // 其他导航方法同理，比如push、pop等
}

然后在MaterialApp里配置navigatorKey：

MaterialApp(
  navigatorKey: NavigationService.navigatorKey,
  // ...其他配置
)

之后所有页面跳转都用NavigationService.pushNamed()，就能自动带上Token检查了。

总的来说，这几种方式都能帮你把检查逻辑集中在一处，不用在每个页面重复造轮子。推荐优先考虑路由守卫或者结合状态管理的方案，代码更整洁，扩展性也更强。

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