跨平台开发 / 系统课时

在请求中自动携带 Token

在请求中自动携带 Token

移动应用中的大量接口都需要身份认证。手动为每个请求添加 Token 容易遗漏,也难以统一维护。本篇使用拦截器机制,让认证信息自动加入请求头,并验证请求发送时的实际效果。

学习目标

  • 理解 HTTP 请求拦截器在鉴权中的作用。
  • 使用 Dio 为认证接口自动添加 Authorization 头。
  • 掌握 Token 缺失时的处理边界。

使用拦截器统一处理认证信息

如果每个接口调用处都编写认证代码,会产生重复逻辑。例如新增接口时忘记添加 Token,就会出现难以定位的 401 错误。

拦截器位于请求发送之前,可以集中修改请求配置。下面示例使用 Dio 的请求拦截器读取本地 Token,并添加到请求头。

dart
import 'package:dio/dio.dart';

class TokenStore {
  String? getToken() {
    return '<TOKEN_VALUE>';
  }
}

void main() {
  final dio = Dio();
  final tokenStore = TokenStore();

  dio.interceptors.add(
    InterceptorsWrapper(
      onRequest: (options, handler) {
        final token = tokenStore.getToken();
        if (token != null) {
          options.headers['Authorization'] = 'Bearer $token';
        }
        handler.next(options);
      },
    ),
  );

  dio.get('https://api.example.com/profile');
}

预期结果

text
发送请求时自动携带请求头:
Authorization: Bearer <TOKEN_VALUE>

处理不同接口的认证需求

并不是所有接口都需要 Token。例如登录接口通常需要提交账号密码获取 Token,如果拦截器强制添加旧 Token,可能造成无效认证。

实际项目中可以通过请求路径或自定义标记判断是否跳过认证:

dart
if (options.extra['skipAuth'] == true) {
  handler.next(options);
  return;
}

预期结果

text
skipAuth 为 true 的请求不会添加 Authorization。
普通业务请求继续自动携带 Token。

Token 失效后的处理边界

自动携带 Token 只能解决请求认证信息注入问题,不能解决 Token 过期。收到 HTTP 401 后,通常需要进入刷新流程:尝试刷新 Token,刷新成功后重新发送原请求;刷新失败则清理登录状态。

需要注意的是,刷新流程不能无限重试,否则可能形成请求循环。通常只允许一次刷新尝试,并对并发请求进行合并处理。

验证请求是否正确携带 Token

开发阶段可以通过网络调试工具或服务端日志确认请求头是否存在。验证重点不是打印真实 Token,而是确认请求流程正确,避免将敏感凭证泄露到日志中。

完成统一拦截后,业务代码只需要关注接口调用,不再重复管理认证头,后续切换 Token 存储方式或增加刷新逻辑时也更容易维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

在请求中自动携带 Token

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

登录哪都通