跨平台开发 / 系统课时

刷新失败后清理登录状态

刷新失败后清理登录状态

refresh token 失效意味着客户端无法继续证明用户身份。此时继续保留旧 Token 会导致大量接口持续失败。本篇介绍如何在 Flutter 应用中安全清理认证数据,并把退出登录交给业务层统一处理。

学习目标

  • 理解 refresh token 失效后的正确处理流程。
  • 实现本地认证信息清理机制。
  • 设计网络层与登录状态管理之间的职责边界。

判断刷新失败的真实含义

access token 过期通常是正常情况,客户端可以通过 refresh token 自动恢复。但 refresh token 也有生命周期,例如:

  • 用户主动退出其他设备。
  • 服务端撤销会话。
  • refresh token 超过有效期。
  • 账号安全策略要求重新认证。

这些情况说明当前登录会话已经无法恢复,客户端应该进入退出登录流程,而不是不断重试刷新。

清理本地认证状态

网络层负责发现认证失败,但不应该直接控制页面跳转。更合理的设计是:

  • 网络层清理无效凭证。
  • 状态管理层接收未登录事件。
  • 页面层根据状态展示登录页面。

这种方式可以避免 Dio、Repository 和页面之间产生强耦合。

下面示例展示一个简单的认证状态管理方式。

dart
class AuthStorage {
  String? accessToken;
  String? refreshToken;

  Future<void> clear() async {
    // 清除内存和持久化存储中的认证信息。
    accessToken = null;
    refreshToken = null;
  }
}

class AuthController {
  final AuthStorage storage;

  AuthController(this.storage);

  Future<void> logout() async {
    await storage.clear();
    _notifyLoggedOut();
  }

  void _notifyLoggedOut() {
    // 实际项目中可通过 Provider、Riverpod、Bloc 等通知页面状态变化。
    print('user logged out');
  }
}

预期输出

text
user logged out

调用清理方法后,应用中的认证状态变为未登录,上层状态管理可以触发路由跳转或显示登录界面。

在网络请求链路中连接退出流程

当刷新接口返回认证失败状态时,请求链路通常如下:

  1. 捕获 refresh token 请求失败。
  2. 删除 access token 和 refresh token。
  3. 发布登录失效事件。
  4. 取消或失败当前需要认证的请求。
  5. 等待用户重新登录。

需要避免的做法是直接在拦截器中调用页面导航。网络层可能运行在没有页面上下文的环境中,而且多个请求同时失败时容易触发重复跳转。

防止异常退出体验

生产环境中还需要处理以下情况:

问题 建议方案
多个请求同时收到登录失效 使用单次事件通知,避免重复弹窗
清理后仍发送旧请求 在请求发送前重新检查 Token
用户正在提交重要操作 根据业务保存必要草稿

刷新失败不是普通网络异常,而是认证状态发生变化的信号。将清理逻辑集中管理,可以让登录状态在整个 Flutter 应用中保持一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

刷新失败后清理登录状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通