跨平台开发 / 系统课时
识别 Token 过期响应
识别 Token 过期响应
本篇介绍如何在 Flutter 网络请求中识别 Token 过期场景,并根据服务端响应判断用户是否需要重新登录或刷新令牌。完成后,你可以建立稳定的鉴权失败处理流程。
学习目标
- 理解 Token 过期响应与普通业务错误的区别。
- 掌握根据 HTTP 状态码和响应字段判断登录失效的方法。
- 能够设计统一的鉴权异常处理入口。
Token 过期响应是什么
移动应用中的访问令牌通常具有有效时间。当服务端发现请求携带的 Token 已失效,会返回特定响应通知客户端停止使用当前身份信息。
客户端不能简单地把所有请求失败都当作 Token 过期。例如网络断开、参数错误、权限不足都可能导致请求失败,需要通过服务端约定进行区分。
常见判断依据包括:
| 判断信息 | 示例 | 作用 |
|---|---|---|
| HTTP 状态码 | 401 Unauthorized | 表示身份认证失败 |
| 错误码字段 | TOKEN_EXPIRED | 精确识别过期原因 |
| 响应消息 | access token expired | 辅助日志分析 |
在 Flutter 中统一处理响应
实际项目通常会在网络层统一检查响应,而不是让每个页面分别判断 Token 状态。例如使用 Dio 时,可以通过拦截器集中处理响应。
下面是一个片段示例,展示根据响应内容判断 Token 是否过期:
dart
import 'package:dio/dio.dart';
bool isTokenExpired(Response response) {
// 服务端通过状态码和业务码共同描述登录失效
if (response.statusCode == 401) {
return true;
}
final data = response.data;
if (data is Map && data['code'] == 'TOKEN_EXPIRED') {
return true;
}
return false;
}预期结果
text
statusCode 为 401 或业务 code 为 TOKEN_EXPIRED 时返回 true
其他响应返回 false区分过期、无权限和业务失败
Token 过期表示当前身份凭证无法继续使用,通常可以尝试刷新 Token。权限不足表示用户身份有效,但没有访问资源的权限,不应该触发刷新。
| 场景 | 是否刷新 Token | 处理方式 |
|---|---|---|
| Token 已过期 | 是 | 调用刷新接口 |
| Token 无效 | 通常否 | 清理登录状态 |
| 权限不足 | 否 | 提示用户无权限 |
| 参数错误 | 否 | 修正请求参数 |
设计统一鉴权异常
建议网络层向业务层抛出明确异常,例如 TokenExpiredException,而不是直接返回原始 HTTP 错误。这样页面代码只关心业务行为,不需要了解服务端协议细节。
实际开发中,Token 判断规则必须与后端接口协议保持一致。如果服务端同时返回状态码和业务错误码,应优先依据稳定的业务错误码处理,避免因为网关配置变化导致误判。
按自己的节奏,确认真正理解。