身份认证与应用安全 / 系统课时

Token 过期时统一处理 401

Token 过期时统一处理 401

登录成功并不代表会话一直有效。访问令牌过期后,如果每个页面各自判断 401,清理 Token、跳转登录页和提示用户的逻辑会迅速重复。本节把 401 收口到统一请求层,让业务代码只处理正常结果和真正的业务错误。

学习目标

  • 能在统一请求函数中识别 HTTP 401,并清理本地认证状态。
  • 能区分“认证失效”和普通 4xx、5xx,避免所有错误都跳回登录页。
  • 能用受保护接口验证 Token 失效后的浏览器行为。

为什么要在请求层统一处理

JWT 常见做法是把访问令牌放进 Authorization: Bearer <token>。当令牌过期、签名无效或服务端判定当前身份不可用时,受保护接口应返回 401。真正麻烦的不是识别这个状态码,而是所有调用点都可能遇到它。

如果页面 A、B、C 都分别写“遇到 401 就删除 Token 并跳转”,很容易出现重复弹窗、连续跳转,甚至一个请求正在重定向时另一个请求又覆盖页面状态。统一请求层只做一次认证失效处理,业务函数不再关心 Token 生命周期。

401 统一处理流程

用 fetch 封装统一的 401 入口

下面是片段示例,适合放在前端的 API 模块中;它依赖浏览器环境、现有 /login 页面以及后端受保护接口 /api/profile。关键点是:401 在统一层消费并转成明确的 AUTH_EXPIRED,业务代码不会再次执行通用错误处理。

js
const AUTH_STORAGE_KEY = "access_token";

async function apiFetch(input, init = {}) {
  const token = localStorage.getItem(AUTH_STORAGE_KEY);
  const headers = new Headers(init.headers || {});

  if (token) {
    headers.set("Authorization", `Bearer ${token}`);
  }

  const response = await fetch(input, { ...init, headers });

  if (response.status === 401) {
    localStorage.removeItem(AUTH_STORAGE_KEY);
    window.dispatchEvent(new CustomEvent("auth:expired"));
    throw new Error("AUTH_EXPIRED");
  }

  return response;
}

window.addEventListener("auth:expired", () => {
  if (window.location.pathname === "/login") {
    return;
  }

  const next = encodeURIComponent(
    window.location.pathname + window.location.search
  );
  window.location.assign(`/login?reason=expired&next=${next}`);
});

async function loadProfile() {
  try {
    const response = await apiFetch("/api/profile");

    if (!response.ok) {
      throw new Error(`HTTP_${response.status}`);
    }

    const profile = await response.json();
    console.log(profile);
  } catch (error) {
    if (error instanceof Error && error.message === "AUTH_EXPIRED") {
      return;
    }

    console.error(error);
  }
}

loadProfile();

这段代码把“认证已经失效”和“接口自身失败”分开处理。403 不应当复用这条分支:401 表示当前请求没有有效认证身份,而 403 通常表示身份已经确认,但没有访问该资源的权限。

先确认后端确实返回 401

统一处理能否工作,前提是后端认证失败时使用正确的 HTTP 状态码。可以用一个明显无效的 Token 请求受保护接口,先排除“后端返回 200 再在响应体里写未登录”这类协议问题。

bash
curl -i \
  -H "Authorization: Bearer invalid-token" \
  "http://localhost:<PORT>/api/profile"

<PORT> 替换为当前 Spring Boot 服务实际端口,不同环境的实际值可能不同。

预期输出的关键部分是状态行为;响应头和响应体会随项目配置变化:

text
HTTP/1.1 401

如果这里得到 401,而浏览器端仍没有清理 Token,应把排查重点放到请求是否经过 apiFetch、401 是否被其他封装提前吞掉,以及重定向逻辑是否被重复触发。

不要把自动刷新和 401 清理混在一起

后续如果加入 Refresh Token,401 统一入口仍然有价值,但流程会变成“首次 401 先尝试刷新,刷新成功后重放原请求;刷新也失败时才清理状态并重新登录”。这意味着当前封装最好把 401 识别集中在一处,而不是把跳转语句散落到每个页面。

当前阶段只做“清理并重新登录”最容易验证:令牌失效后,受保护请求返回 401,本地访问令牌被删除,页面统一进入登录流程;其他错误继续交给原业务调用方处理。

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

目录与阅读设置

阅读设置

17

记录一个想法

Token 过期时统一处理 401

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

登录哪都通