跨平台开发 / 系统课时
刷新 Token 后重放请求
刷新 Token 后重放请求
本篇介绍 Flutter 应用中 Token 刷新后的请求恢复机制。你将学习如何保存失败请求、完成令牌刷新,并在刷新成功后自动重新执行原请求,避免用户在登录状态短暂失效时重复操作。
学习目标
- 理解 Token 刷新与原请求重放的处理流程。
- 掌握在网络拦截器中保存和恢复请求的方法。
- 了解并发请求刷新 Token 时需要注意的问题。
Token 刷新的处理流程
当接口返回 Token 过期时,客户端通常不会立即跳转登录页,而是先尝试使用 Refresh Token 获取新的 Access Token。
典型流程如下:
- 原请求携带旧 Access Token 访问服务端。
- 服务端返回 Token 过期响应。
- 客户端暂停失败请求。
- 调用刷新接口获取新 Token。
- 更新本地 Token。
- 使用新 Token 重新发送原请求。

保存失败请求并重新发送
以 Dio 为例,请求重放需要保存原请求配置。下面示例展示核心处理逻辑,省略具体 Token 存储实现。
dart
import 'package:dio/dio.dart';
class AuthInterceptor extends Interceptor {
final Dio dio;
bool refreshing = false;
AuthInterceptor(this.dio);
@override
void onError(DioException err, ErrorInterceptorHandler handler) async {
final response = err.response;
if (response?.statusCode != 401) {
handler.next(err);
return;
}
if (!refreshing) {
refreshing = true;
await refreshToken();
refreshing = false;
}
// 使用更新后的 Token 再次执行原请求
final options = err.requestOptions;
final retryResponse = await dio.fetch(options);
handler.resolve(retryResponse);
}
Future<void> refreshToken() async {
// 实际项目中这里调用刷新接口并保存新 Token
}
}预期结果
text
收到 401 响应后执行 refreshToken,刷新成功后重新发送原请求处理并发刷新问题
多个接口可能同时发现 Token 过期。如果每个请求都独立刷新 Token,会造成重复刷新甚至覆盖新旧 Token。
常见做法是增加刷新锁:第一个请求负责刷新,其余请求等待刷新结果,再统一重试。
| 方案 | 特点 |
|---|---|
| 每个请求单独刷新 | 实现简单,但容易产生并发问题 |
| 单次刷新锁 | 推荐方式,减少无效刷新 |
| 请求队列 | 适合大量并发请求场景 |
重放请求时的边界问题
请求重放并不适用于所有接口。上传文件、支付提交等具有副作用的操作,需要确认服务端是否支持重复提交。
对于普通查询接口和幂等更新接口,可以自动重试;对于不可重复执行的操作,应结合请求唯一 ID 或业务确认机制避免重复执行。
验证刷新流程
测试 Token 刷新逻辑时,可以主动让 Access Token 失效,然后观察:
- 原请求是否收到 401。
- 刷新接口是否只调用一次。
- 新 Token 是否保存成功。
- 原请求是否使用新 Token 返回正常结果。
一个可靠的鉴权层不仅要能刷新 Token,还要控制刷新过程中的并发、失败恢复和请求安全边界。
按自己的节奏,确认真正理解。