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
相关产品推荐
相关产品推荐

