Spring Cloud API Gateway JWT验证报错及空指针问题求助

1. 解决java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter #

这个错误是因为JDK 9及以上版本移除了JAXB相关模块，而早期版本的JJWT（io.jsonwebtoken）依赖DatatypeConverter处理Base64编码。有两种解决方式：

方案一：添加JAXB依赖（适合不想升级JJWT的场景） #

如果用Maven，把以下依赖加入pom.xml：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.1</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0.1</version>
</dependency>
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>

如果用Gradle，加入：

implementation 'javax.xml.bind:jaxb-api:2.3.1'
runtimeOnly 'com.sun.xml.bind:jaxb-impl:2.3.1'
implementation 'com.sun.xml.bind:jaxb-core:2.3.0.1'
implementation 'javax.activation:activation:1.1.1'

方案二：升级JJWT版本（推荐） #

JJWT 0.11.0+版本已移除对JAXB的依赖，改用Java原生Base64工具类，更简洁。Maven依赖：

<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-api</artifactId>
    <version>0.11.5</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-impl</artifactId>
    <version>0.11.5</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-jackson</artifactId>
    <version>0.11.5</version>
    <scope>runtime</scope>
</dependency>

Gradle依赖：

implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.11.5'
runtimeOnly 'io.jsonwebtoken:jjwt-jackson:0.11.5'

2. 解决java.lang.NullPointerException: Cannot invoke "io.jsonwebtoken.Claims.get(Object)" because "claims" is null #

这个异常说明解析JWT后得到的Claims对象为null，核心原因是Token解析失败但代码未处理异常，直接尝试调用Claims方法。按以下步骤排查：

步骤1：检查Token格式与提取逻辑 #

确保前端传递的Token是Bearer <token>格式，你的代码已正确提取<token>部分（比如去掉"Bearer "前缀），避免把整个字符串传给解析方法。

步骤2：添加异常捕获，明确失败原因 #

修改JwtUtils的解析代码，捕获JJWT抛出的各类异常，定位具体问题：

public Claims parseToken(String authToken) {
    try {
        Jws<Claims> claimsJws = Jwts.parser()
                .setSigningKey(jwtSecret)
                .parseClaimsJws(authToken);
        return claimsJws.getBody();
    } catch (ExpiredJwtException e) {
        throw new RuntimeException("Token已过期", e);
    } catch (SignatureException e) {
        throw new RuntimeException("Token签名无效", e);
    } catch (MalformedJwtException e) {
        throw new RuntimeException("Token格式非法", e);
    } catch (IllegalArgumentException e) {
        throw new RuntimeException("Token为空或参数错误", e);
    }
}

步骤3：验证密钥一致性 #

确认解析Token用的jwtSecret和生成Token时使用的密钥完全一致：

• 对称加密场景：密钥字符串必须完全相同；
• 非对称加密场景：解析用的公钥要和生成用的私钥配对。

步骤4：校验Token有效性 #

用JWT在线工具（如jwt.io）验证Token的结构、签名、过期时间，确认Token本身未被篡改、未过期。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu