跨平台开发 / 系统课时
避免多个请求重复刷新 Token
避免多个请求重复刷新 Token
当多个接口同时返回 Token 过期时,如果每个请求都独立执行刷新流程,会产生重复刷新、状态覆盖甚至登录异常。本篇通过请求队列和单次刷新锁解决并发刷新竞争,让多个失败请求共享同一次刷新结果。
学习目标
- 理解并发请求触发 Token 刷新的竞争问题。
- 使用刷新锁和等待队列设计单次刷新机制。
- 在 Flutter 网络层实现可复用的 Token 刷新控制逻辑。
为什么会出现重复刷新问题
移动应用通常会在请求拦截器中检查接口响应。当访问令牌过期时,请求需要暂停并使用 refresh token 获取新的 access token。
如果用户同时触发多个接口请求,例如首页加载、消息同步和个人信息查询同时发生,那么它们可能在同一时间发现 Token 已失效。
如果没有并发控制,三个请求会同时调用刷新接口:
- 请求 A 刷新 Token,得到新令牌。
- 请求 B 同时刷新 Token,覆盖 A 的结果。
- 请求 C 使用已经失效的 refresh token 刷新失败。
最终表现为用户明明登录有效,却突然被要求重新登录。
使用单次刷新锁协调请求
核心思路是让刷新过程具有唯一性:第一个发现 Token 失效的请求负责刷新,其他请求等待刷新结果。

实现时通常需要保存一个正在进行的刷新 Future,后续请求直接等待该 Future 完成,而不是重新调用刷新接口。
在 Dio 拦截器中实现刷新协调
下面示例展示核心逻辑。实际项目中需要根据认证服务调整接口地址和 Token 存储方式。
dart
import 'package:dio/dio.dart';
class TokenManager {
Future<String>? _refreshing;
Future<String> refreshToken() {
// 已经有刷新任务时,复用同一个 Future。
return _refreshing ??= _requestNewToken();
}
Future<String> _requestNewToken() async {
try {
// 这里替换为真实 refresh token 请求。
await Future.delayed(const Duration(milliseconds: 500));
return 'new-access-token';
} finally {
// 无论成功失败,都允许下一次重新刷新。
_refreshing = null;
}
}
}预期输出
text
第一次调用 refreshToken 创建刷新任务。
后续并发调用等待同一个刷新结果。
刷新完成后所有请求获得相同的新 access token。在请求重试阶段,等待刷新完成的请求需要重新读取最新 Token,然后重新发送原请求,避免继续使用旧凭证。
处理刷新过程中的边界情况
并发刷新控制还需要考虑几个边界:
| 情况 | 处理方式 |
|---|---|
| 刷新成功 | 更新本地 Token,并重试原请求 |
| 刷新失败 | 清理认证状态,交给登录流程处理 |
| 刷新超时 | 设置超时并终止等待请求 |
| 多次重试 | 限制最大重试次数,避免死循环 |
单次刷新机制适合绝大多数移动应用网络层设计。它的关键不是阻止请求失败,而是让失败后的恢复过程只有一个协调者。
按自己的节奏,确认真正理解。