身份认证与应用安全 / 系统课时
登录后携带 Bearer Token
登录后携带 Bearer Token
登录接口返回 JWT 以后,真正容易出错的不是“拿到 Token”,而是每个业务请求都要稳定、统一地携带它。本节用一个前端请求封装把 Authorization: Bearer <TOKEN> 集中处理,并补上 401 与跨域请求等关键边界。
学习目标
- 正确理解 Bearer Token 在 HTTP 请求头中的格式与发送时机。
- 用统一请求函数自动附加 JWT,避免业务代码重复拼接请求头。
- 识别 Token 缺失、失效以及误发到第三方地址等常见问题。
为什么要在请求层统一处理
Bearer Token 的标准形态是 Authorization: Bearer <TOKEN>,Bearer 与 Token 之间必须有一个空格。若在每个页面分别读取 Token、拼接请求头,很容易出现漏加、拼错,或者某个接口仍在使用旧逻辑。
更稳妥的做法是让所有需要认证的后端请求经过同一个请求函数。业务代码只关心“请求哪个接口”,认证细节由请求层统一完成。Token 存在时附加请求头,不存在时保持普通请求,让服务端按接口规则决定是否允许访问。
用 fetch 封装认证请求
下面是片段示例。它假设登录成功后已把 JWT 保存到 localStorage 的 access_token,并且前端只通过同源 /api 前缀访问自己的后端。真实项目若使用内存存储、Pinia、Redux 或其他方案,只需要替换读取 Token 的位置。
const API_BASE = "/api";
async function apiFetch(path, options = {}) {
if (!path.startsWith("/")) {
throw new Error("path 必须以 / 开头");
}
const headers = new Headers(options.headers || {});
const token = localStorage.getItem("access_token");
if (token) {
headers.set("Authorization", `Bearer ${token}`);
}
const response = await fetch(`${API_BASE}${path}`, {
...options,
headers,
});
if (response.status === 401) {
localStorage.removeItem("access_token");
}
return response;
}
async function loadProfile() {
const response = await apiFetch("/profile");
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return response.json();
}预期结果
当本地存在有效 JWT 时,在浏览器开发者工具的 Network 请求头中应能看到类似内容:
GET /api/profile
Authorization: Bearer <TOKEN><TOKEN> 会替换为实际 JWT;接口响应体由你的后端定义。如果 Token 已失效并返回 401,上面的封装会删除本地旧 Token,避免后续请求继续携带它。
不要把 Token 发给不受信任的地址
统一封装还有一个安全收益:可以限制认证请求只发往自己的 API。若直接写成“对任意 URL 都自动附加 Authorization”,一旦业务代码请求第三方资源,就可能把 JWT 一并泄露出去。示例用固定 API_BASE 和相对路径,就是为了缩小 Token 的发送范围。
localStorage 只是常见存储方式,并不等于最安全方案。它能被页面 JavaScript 读取,因此一旦站点存在 XSS,Token 也可能被窃取。无论采用哪种存储方式,都应把“Token 存在哪里”和“请求层如何携带 Token”分开设计。
401 应由统一层识别,页面负责跳转
请求层适合统一识别 401、清理失效 Token,并向上返回结果;是否跳转登录页、是否弹提示,则通常交给路由或页面状态层决定。这样可以避免多个并发请求同时触发重复跳转,也不会把 UI 行为硬编码进底层网络函数。
当所有受保护接口都通过同一个请求层发送后,业务页面就不再需要重复拼接 Bearer,认证逻辑也更容易集中修改和排查。