跨平台开发 / 系统课时
刷新失败后清理登录状态
刷新失败后清理登录状态
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调用清理方法后,应用中的认证状态变为未登录,上层状态管理可以触发路由跳转或显示登录界面。
在网络请求链路中连接退出流程
当刷新接口返回认证失败状态时,请求链路通常如下:
- 捕获 refresh token 请求失败。
- 删除 access token 和 refresh token。
- 发布登录失效事件。
- 取消或失败当前需要认证的请求。
- 等待用户重新登录。
需要避免的做法是直接在拦截器中调用页面导航。网络层可能运行在没有页面上下文的环境中,而且多个请求同时失败时容易触发重复跳转。
防止异常退出体验
生产环境中还需要处理以下情况:
| 问题 | 建议方案 |
|---|---|
| 多个请求同时收到登录失效 | 使用单次事件通知,避免重复弹窗 |
| 清理后仍发送旧请求 | 在请求发送前重新检查 Token |
| 用户正在提交重要操作 | 根据业务保存必要草稿 |
刷新失败不是普通网络异常,而是认证状态发生变化的信号。将清理逻辑集中管理,可以让登录状态在整个 Flutter 应用中保持一致。
按自己的节奏,确认真正理解。