JJWT库ExpiredJWTException捕获问题：过期令牌异常无法捕获

我之前也碰到过一模一样的情况——明明令牌过期时应该抛出ExpiredJWTException，但自己写的catch块就是抓不到，大概率是这几个原因导致的，你可以逐一排查：

1. 确认异常类的导入路径正确 #

首先要确保你导入的是JJWT官方的ExpiredJWTException，它的全类名是io.jsonwebtoken.ExpiredJWTException。有时候IDE会自动导入其他库的同名类（虽然概率低，但先排除这个可能），检查一下import语句，避免导错包。

2. 确保try块覆盖了JWT解析的核心代码 #

一定要把JJWT解析令牌的关键调用完全包裹在try块内，比如parseClaimsJws()（或新版本的parse()方法）必须在try范围内。给你一个正确的代码示例：

import io.jsonwebtoken.ExpiredJWTException;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.Jws;
import io.jsonwebtoken.Claims;

public void validateToken(String token) {
    try {
        // 核心解析操作必须放在try块内
        Jws<Claims> claimsJws = Jwts.parser()
                .setSigningKey(yourSecretKey) // 替换成你的密钥
                .build()
                .parseClaimsJws(token);
        
        // 令牌有效时的处理逻辑
        System.out.println("令牌验证通过，用户ID：" + claimsJws.getBody().getSubject());
    } catch (ExpiredJWTException e) {
        // 这里就能捕获到令牌过期的异常了
        System.out.println("令牌已过期：" + e.getMessage());
        // 执行你的后续操作，比如返回过期提示、引导重新登录等
    } catch (Exception e) {
        // 兜底捕获其他异常，方便排查问题
        System.err.println("捕获到异常：" + e.getClass().getName() + "，信息：" + e.getMessage());
        e.printStackTrace();
    }
}

3. 排查上层代码是否提前捕获了异常 #

如果你的验证逻辑是在Spring过滤器、拦截器或者全局异常处理器之前执行，可能上层代码已经捕获了RuntimeException（ExpiredJWTException属于RuntimeException子类），导致你的catch块没机会触发。

比如在Spring Security环境下，检查自定义过滤器里有没有捕获所有异常的逻辑，或者看看全局异常处理器是否优先处理了JWT相关异常。这种情况下，你可以调整异常处理的优先级，或者直接在全局异常处理器中专门处理ExpiredJWTException。

4. 先捕获宽泛异常排查问题 #

如果还是抓不到，你可以先尝试捕获JwtException（ExpiredJWTException的直接父类）甚至RuntimeException，然后打印异常的完整类名和堆栈信息，确认是不是真的抛出了ExpiredJWTException，还是被包装成了其他业务异常（有些框架会把底层异常包装成自己的异常类型）。

比如加一个临时的catch块：

catch (RuntimeException e) {
    System.out.println("实际捕获的异常类型：" + e.getClass().getName());
    e.printStackTrace();
}

这样能帮你定位到底抛出的是什么异常，再针对性处理。

5. 检查JJWT版本兼容性 #

不同版本的JJWT API有差异，比如旧版本（0.9.x）的解析方式是Jwts.parser().setSigningKey(secret).parseClaimsJws(token)，而新版本（0.11.x+）需要调用build()构建parser。如果API使用错误，可能抛出的异常也不符合预期，建议确认你使用的JJWT版本和对应API是否匹配。

内容的提问来源于stack exchange，提问作者user8920693