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

读取 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。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取 Authorization 请求头

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

登录哪都通