跨平台开发 / 系统课时

避免多个请求重复刷新 Token

避免多个请求重复刷新 Token

当多个接口同时返回 Token 过期时,如果每个请求都独立执行刷新流程,会产生重复刷新、状态覆盖甚至登录异常。本篇通过请求队列和单次刷新锁解决并发刷新竞争,让多个失败请求共享同一次刷新结果。

学习目标

  • 理解并发请求触发 Token 刷新的竞争问题。
  • 使用刷新锁和等待队列设计单次刷新机制。
  • 在 Flutter 网络层实现可复用的 Token 刷新控制逻辑。

为什么会出现重复刷新问题

移动应用通常会在请求拦截器中检查接口响应。当访问令牌过期时,请求需要暂停并使用 refresh token 获取新的 access token。

如果用户同时触发多个接口请求,例如首页加载、消息同步和个人信息查询同时发生,那么它们可能在同一时间发现 Token 已失效。

如果没有并发控制,三个请求会同时调用刷新接口:

  • 请求 A 刷新 Token,得到新令牌。
  • 请求 B 同时刷新 Token,覆盖 A 的结果。
  • 请求 C 使用已经失效的 refresh token 刷新失败。

最终表现为用户明明登录有效,却突然被要求重新登录。

使用单次刷新锁协调请求

核心思路是让刷新过程具有唯一性:第一个发现 Token 失效的请求负责刷新,其他请求等待刷新结果。

Flutter 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,并重试原请求
刷新失败 清理认证状态,交给登录流程处理
刷新超时 设置超时并终止等待请求
多次重试 限制最大重试次数,避免死循环

单次刷新机制适合绝大多数移动应用网络层设计。它的关键不是阻止请求失败,而是让失败后的恢复过程只有一个协调者。

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

目录与阅读设置

阅读设置

17

记录一个想法

避免多个请求重复刷新 Token

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

登录哪都通