身份认证与应用安全 / 系统课时
读取 Authorization 请求头
读取 Authorization 请求头
前后端分离接口通常把访问令牌放在 Authorization 请求头中。本节只解决入口解析问题:识别 Bearer Token,并把“未携带”“前缀错误”“令牌为空”等情况明确区分,避免后续过滤器把格式错误误当成正常匿名请求。
学习目标
- 使用 Servlet API 读取
Authorization请求头并识别 Bearer Token。 - 区分请求头缺失、Bearer 前缀错误、空令牌与有效令牌。
- 为后续 JWT 校验保留清晰、可测试的解析结果。
Bearer 请求头应该解析什么
典型请求头形态是 Authorization: Bearer <token>。读取时不要直接截取固定下标后就进入 JWT 解析,因为真实请求可能完全没有该头,也可能只有 Bearer、使用错误前缀,甚至在令牌中混入空白字符。
对登录认证链而言,至少应区分四种结果:未提供请求头、格式不合法、Bearer 后没有令牌、成功取得令牌。这样后续代码才能决定“继续按匿名请求处理”还是“立即返回 401”。
编写独立解析器
下面是片段示例,放入已有的 Spring Boot Web 项目即可使用。它只负责读取和解析请求头,不在这一层验证签名、过期时间或用户身份。
java
package com.example.security;
import jakarta.servlet.http.HttpServletRequest;
import org.springframework.http.HttpHeaders;
public final class AuthorizationHeaderParser {
private AuthorizationHeaderParser() {
}
public enum Status {
MISSING,
INVALID_FORMAT,
EMPTY_TOKEN,
PRESENT
}
public record Result(Status status, String token) {
}
public static Result parse(HttpServletRequest request) {
String header = request.getHeader(HttpHeaders.AUTHORIZATION);
if (header == null || header.isBlank()) {
return new Result(Status.MISSING, null);
}
String value = header.trim();
if (value.equalsIgnoreCase("Bearer")) {
return new Result(Status.EMPTY_TOKEN, null);
}
if (!value.regionMatches(true, 0, "Bearer ", 0, 7)) {
return new Result(Status.INVALID_FORMAT, null);
}
String token = value.substring(7).trim();
if (token.isEmpty()) {
return new Result(Status.EMPTY_TOKEN, null);
}
if (token.chars().anyMatch(Character::isWhitespace)) {
return new Result(Status.INVALID_FORMAT, null);
}
return new Result(Status.PRESENT, token);
}
}预期结果
| 输入请求头 | 解析状态 | token |
|---|---|---|
未携带 Authorization |
MISSING |
null |
Authorization: Basic abc |
INVALID_FORMAT |
null |
Authorization: Bearer |
EMPTY_TOKEN |
null |
Authorization: Bearer |
EMPTY_TOKEN |
null |
Authorization: Bearer eyJ... |
PRESENT |
eyJ... |
这里把认证方案名称按大小写不敏感方式比较,但仍要求 Bearer 后存在分隔空格。令牌内部出现空白时直接判为格式错误,因为 JWT 的紧凑序列化结果本身不应包含空格。
在鉴权入口处理边界
解析器只回答“请求头里有什么”,不负责决定 HTTP 响应。常见策略是:MISSING 时继续过滤链,让公开接口正常访问,并由后面的授权规则决定受保护接口是否返回 401;INVALID_FORMAT 或 EMPTY_TOKEN 则可直接进入统一的认证失败处理。
把请求头解析与 JWT 验签拆开后,边界会更清楚:这一层只产生结构化结果,下一层再处理签名、过期时间、用户加载和 SecurityContext。
按自己的节奏,确认真正理解。