跨平台开发 / 系统课时

识别 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 判断规则必须与后端接口协议保持一致。如果服务端同时返回状态码和业务错误码,应优先依据稳定的业务错误码处理,避免因为网关配置变化导致误判。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别 Token 过期响应

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

登录哪都通