如何诊断和修复 ‘Bearer Token is Malformed’ 错误：从原理到实践

1次阅读

共计 2006 个字符，预计需要花费 6 分钟才能阅读完成。

Bearer Token 是 OAuth 2.0 协议中用于授权访问受保护资源的关键凭证。它以字符串形式传递，通常采用 JWT（JSON Web Token）格式。然而，在实际开发中，开发者经常会遇到 ‘Bearer Token is Malformed’ 错误，主要原因包括：

Base64 解码失败 ：Token 的 Header 或 Payload 部分可能因填充错误或非法字符导致解码异常
JWT 结构错误 ：缺少必要的部分（如 Header、Payload、Signature 未用点号分隔）或字段不完整
签名不匹配 ：密钥不一致或签名算法配置错误
过期时间无效 ：exp 字段格式错误或已过期

不同语言的常用库对比：

Java：
java-jwt：轻量级，支持主流算法
jose4j：功能全面，支持 JWE
Python：
PyJWT：使用最广泛
python-jose：支持多后端加密库

import com.auth0.jwt.JWT;
import com.auth0.jwt.algorithms.Algorithm;
import com.auth0.jwt.exceptions.JWTVerificationException;
import com.auth0.jwt.interfaces.DecodedJWT;

public class TokenValidator {
    private static final String SECRET = "your-256-bit-secret";

    public static boolean validateToken(String token) {
        try {
            // 验证签名并解码
            DecodedJWT jwt = JWT.require(Algorithm.HMAC256(SECRET))
                .build()
                .verify(token);

            // 检查过期时间（库已自动验证 exp）System.out.println("Token expires at:" + jwt.getExpiresAt());
            return true;
        } catch (JWTVerificationException e) {
            // 捕获具体异常类型
            if (e.getMessage().contains("expired")) {System.err.println("Token expired");
            } else {System.err.println("Invalid token:" + e.getMessage());
            }
            return false;
        }
    }
}

import jwt
from datetime import datetime, timezone

def validate_token(token: str) -> bool:
    try:
        # 解码并验证
        payload = jwt.decode(
            token,
            "your-256-bit-secret",
            algorithms=["HS256"],
            options={"require_exp": True}
        )
        print(f"Token valid until: {datetime.fromtimestamp(payload['exp'], timezone.utc)}")
        return True
    except jwt.ExpiredSignatureError:
        print("Token expired")
    except jwt.InvalidTokenError as e:
        print(f"Invalid token: {str(e)}")
    return False