You need to enable JavaScript to run this app. Flutter开发中Dio拦截器未在401响应下执行Token刷新方法的问题
优惠活动
大模型
产品
解决方案
定价
更多

Flutter开发中Dio拦截器未在401响应下执行Token刷新方法的问题

现有实现的核心问题
  • 拦截器错误处理流程完全不闭环
    你在onError回调中判断到401/403状态后,虽然编写了刷新token、触发重试的代码,但最后直接返回原始的错误响应,既没有接住_retry的执行结果,也没有把重试后的正常响应透传给外层调用。这种写法会导致:就算if分支被触发了,外层dio.post依然会直接接收到最开始的401错误,触发外层的on DioError catch逻辑,从调试视角看,就像if分支完全没执行一样。
  • 重试请求复用了过期的旧鉴权头
    你的_retry函数直接沿用原请求的headers,而refreshToken执行拿到新token后,既没有更新本地存储的token值,也没有把新的access token替换到重试请求的Header中,就算重试逻辑触发,发出去的请求依然带着过期的旧token,还是会拿到401。
  • 刷新接口的请求格式不匹配后端要求
    你调用刷新接口时用FormData传递refresh参数,绝大多数后端JWT刷新接口默认要求接收JSON结构的请求体,FormData格式的参数后端无法正确解析,根本不会返回新的有效token。
  • 缺少并发防重入逻辑
    当多个并行请求同时触发401时,会重复发起多次token刷新请求,甚至会因为不同刷新请求返回的新token互相覆盖,导致后续所有请求的鉴权全部失效。
修正实现的核心方向
  • 将Dio实例抽为全局单例,不要每次发起请求时新建实例
  • 用Completer做并发锁,保证同一时间只有一个刷新token的请求在执行,其他触发401的请求等待刷新完成后再统一重试
  • 刷新接口改用JSON格式传参,不要使用FormData
  • 刷新完成后把新的access token更新到本地存储,替换重试请求中的Authorization头
  • 拦截器内接住重试的响应结果,直接作为onError的返回值透传给外层调用,阻断原始401错误的抛出

排查提示:如果服务端日志已经确认返回401,但拦截器内的状态码判断始终不触发,可以先在onError回调的第一行打印error.response?.statusCode的实际值,排查是否存在代理截断响应、网络层提前中断、Dio实例validateStatus配置异常等问题。

内容的提问来源于stack exchange,提问作者Maverick

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 15:36:10