Flutter中用go_router与Firebase Authentication处理路由内登出/会话过期

针对你遇到的问题，最简洁高效的方案是利用go_router的refreshListenable特性+全局监听Firebase认证状态，完全不需要在每个页面单独加BlocListener，一次性解决所有页面的登出/会话过期跳转问题。

核心思路 #

go_router支持通过refreshListenable参数监听一个可通知对象（比如ChangeNotifier），当这个对象的状态变化时，会自动触发路由的重定向逻辑重新执行。结合Firebase Auth的authStateChanges()流，我们可以把认证状态封装成一个全局的可通知对象，一旦用户登出或会话过期，就通知go_router刷新路由，自动跳转到登录页。

具体实现步骤 #

1. 封装全局认证状态管理

创建一个AuthNotifier类，负责监听Firebase的认证状态变化，并对外暴露登录状态：

import 'package:firebase_auth/firebase_auth.dart';
import 'package:flutter/foundation.dart';

class AuthNotifier extends ChangeNotifier {
  final FirebaseAuth _auth = FirebaseAuth.instance;
  User? _currentUser;

  AuthNotifier() {
    // 监听Firebase认证状态变化
    _auth.authStateChanges().listen((User? user) {
      _currentUser = user;
      // 状态变化时通知go_router刷新
      notifyListeners();
    });
  }

  // 对外提供登录状态判断
  bool get isLoggedIn => _currentUser != null;

  // 主动登出方法（直接调用Firebase的signOut也可以）
  Future<void> signOut() async {
    await _auth.signOut();
  }
}

2. 配置go_router关联认证状态

在初始化go_router时，把AuthNotifier实例传给refreshListenable，并完善重定向逻辑：

import 'package:go_router/go_router.dart';

// 全局实例化AuthNotifier
final authNotifier = AuthNotifier();

final appRouter = GoRouter(
  refreshListenable: authNotifier,
  // 重定向逻辑：未登录且不在登录页时跳转到登录；已登录且在登录页时跳转到首页
  redirect: (context, state) {
    final isLoggedIn = authNotifier.isLoggedIn;
    final isLoginPage = state.location == '/login';

    if (!isLoggedIn && !isLoginPage) {
      return '/login';
    }
    if (isLoggedIn && isLoginPage) {
      return '/home';
    }
    // 不需要重定向时返回null
    return null;
  },
  routes: [
    GoRoute(
      path: '/login',
      builder: (context, state) => const LoginPage(),
    ),
    GoRoute(
      path: '/home',
      builder: (context, state) => const HomePage(),
    ),
    // 其他需要认证的页面路由（比如账户管理、交易页等）
    GoRoute(
      path: '/account',
      builder: (context, state) => const AccountPage(),
    ),
  ],
);

3. 集成到App根Widget

把配置好的router传给MaterialApp.router：

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(
      routerConfig: appRouter,
      title: 'Flutter App',
    );
  }
}

额外优化：处理会话过期细节 #

如果需要更精准监听token过期（比如Firebase的idToken过期但用户还处于登录状态的情况），可以在AuthNotifier里同时监听idTokenChanges()，当token失效时主动触发登出或状态更新：

AuthNotifier() {
  // 监听认证状态变化
  _auth.authStateChanges().listen((user) {
    _currentUser = user;
    notifyListeners();
  });

  // 监听token变化，处理过期场景
  _auth.idTokenChanges().listen((user) {
    if (user != null) {
      user.getIdTokenResult().then((result) {
        if (result.expirationTime!.isBefore(DateTime.now())) {
          // token已过期，主动登出
          _auth.signOut();
        }
      });
    }
  });
}

为什么这个方案更好 #

• 无冗余代码：不需要在每个页面写监听逻辑，所有跳转逻辑集中在路由配置里
• 自动触发：不管是用户主动登出，还是会话过期导致的被动登出，都会自动触发路由重定向
• 符合go_router设计理念：官方推荐用refreshListenable处理动态路由权限变化场景

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