Flutter页面切换时检测Auth Session有效性的最佳位置咨询

这是个非常典型的跨端App认证场景，结合你已经封装了原生认证插件的情况，我给你整理几个最实用的实现方案，你可以根据项目的路由架构来选择：

方案1：全局路由监听（RouteObserver） #

这是我个人最推荐给大多数项目的方案，不需要每个页面单独写检查逻辑，全局统一处理：

实现步骤： #

1. 创建一个自定义的RouteObserver子类，重写路由切换的回调方法，在里面执行认证检查：

class AuthRouteObserver extends RouteObserver<PageRoute<dynamic>> {
  final NativeAuthPlugin authPlugin = NativeAuthPlugin();

  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPush(route, previousRoute);
    _checkAuthStatus(route);
  }

  @override
  void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPop(route, previousRoute);
    if (previousRoute != null) {
      _checkAuthStatus(previousRoute);
    }
  }

  Future<void> _checkAuthStatus(Route<dynamic> route) async {
    // 过滤不需要检查的页面，比如登录页、注册页
    if (route.settings.name == '/login') return;

    // 调用你的原生插件检查Session有效性和认证状态
    bool isSessionValid = await authPlugin.checkSession();
    bool isAuthenticated = await authPlugin.checkAuthStatus();

    if (!isAuthenticated || !isSessionValid) {
      // 调用原生框架处理认证（比如弹出登录弹窗、跳转登录页）
      await authPlugin.handleAuth();
    }
  }
}

2. 在你的MaterialApp或者CupertinoApp中注册这个Observer：

final authRouteObserver = AuthRouteObserver();

MaterialApp(
  navigatorObservers: [authRouteObserver],
  // ...其他配置
);

优点： #

• 全局统一管理，不需要每个页面重复写检查逻辑
• 可以灵活过滤不需要检查的页面
• 兼容传统的Navigator 1.0路由

方案2：Navigator 2.0 RouterDelegate层面控制 #

如果你的项目用的是新版的Navigator 2.0（Router API），那在RouterDelegate里处理认证检查会更优雅，因为路由的控制权完全在你手里：

实现思路： #

在RouterDelegate的setNewRoutePath方法中，先执行认证检查，再决定是否跳转到目标页面：

class AppRouterDelegate extends RouterDelegate<AppRoutePath> with ChangeNotifier, PopNavigatorRouterDelegateMixin<AppRoutePath> {
  final GlobalKey<NavigatorState> navigatorKey;
  final NativeAuthPlugin authPlugin = NativeAuthPlugin();

  AppRouterDelegate() : navigatorKey = GlobalKey<NavigatorState>();

  @override
  Future<void> setNewRoutePath(AppRoutePath path) async {
    // 先检查认证状态
    bool isSessionValid = await authPlugin.checkSession();
    bool isAuthenticated = await authPlugin.checkAuthStatus();

    if (!isAuthenticated || !isSessionValid) {
      // 调用原生处理认证，处理完成后再跳转目标页面
      await authPlugin.handleAuth();
      // 这里可以根据处理结果决定是否继续跳转
    }

    // 处理正常的路由跳转逻辑
    // ...
  }

  // ...其他RouterDelegate实现方法
}

优点： #

• 路由层面的前置检查，逻辑更集中
• 适合复杂的路由场景（比如深层路由跳转时的认证拦截）

方案3：封装BasePage作为所有页面的父类 #

如果你的项目只有部分页面需要认证检查，或者需要每个页面自定义检查逻辑，可以封装一个BasePage：

实现步骤： #

1. 创建一个BaseState类，在里面实现认证检查：

abstract class BaseState<T extends StatefulWidget> extends State<T> {
  final NativeAuthPlugin authPlugin = NativeAuthPlugin();

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _checkAuth();
    });
  }

  Future<void> _checkAuth() async {
    // 这里可以让子类重写是否需要检查
    if (!needCheckAuth()) return;

    bool isSessionValid = await authPlugin.checkSession();
    bool isAuthenticated = await authPlugin.checkAuthStatus();

    if (!isAuthenticated || !isSessionValid) {
      await authPlugin.handleAuth();
    }
  }

  // 子类可以重写这个方法来控制是否需要检查
  bool needCheckAuth() => true;
}

2. 业务页面继承这个BaseState：

class HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends BaseState<HomePage> {
  // 如果这个页面不需要检查，重写needCheckAuth返回false
  // @override
  // bool needCheckAuth() => false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(/* ... */);
  }
}

优点： #

• 每个页面可以灵活控制是否需要检查
• 逻辑和页面绑定，适合个性化需求

方案4：结合状态管理（Bloc/Provider） #

如果你的项目已经用了Bloc、Provider或者Riverpod这类状态管理库，可以把认证状态和路由监听结合起来：

比如用Bloc的话，可以在RouteObserver中触发一个CheckAuthEvent，然后在Bloc中调用原生插件检查，根据结果更新状态，再触发页面跳转或者原生认证处理。

核心思路： #

• 在RouteObserver中触发Bloc事件
• Bloc中执行原生认证检查
• 根据检查结果发送状态，UI层响应状态变化

这个方案适合已经有全局状态管理的项目，能让认证逻辑和状态管理更统一。

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