跨平台开发 / 系统课时

刷新 Token 后重放请求

刷新 Token 后重放请求

本篇介绍 Flutter 应用中 Token 刷新后的请求恢复机制。你将学习如何保存失败请求、完成令牌刷新,并在刷新成功后自动重新执行原请求,避免用户在登录状态短暂失效时重复操作。

学习目标

  • 理解 Token 刷新与原请求重放的处理流程。
  • 掌握在网络拦截器中保存和恢复请求的方法。
  • 了解并发请求刷新 Token 时需要注意的问题。

Token 刷新的处理流程

当接口返回 Token 过期时,客户端通常不会立即跳转登录页,而是先尝试使用 Refresh Token 获取新的 Access Token。

典型流程如下:

  1. 原请求携带旧 Access Token 访问服务端。
  2. 服务端返回 Token 过期响应。
  3. 客户端暂停失败请求。
  4. 调用刷新接口获取新 Token。
  5. 更新本地 Token。
  6. 使用新 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,还要控制刷新过程中的并发、失败恢复和请求安全边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

刷新 Token 后重放请求

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

登录哪都通