异常:java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter

tuokuac2025-09-26 13:31

异常本质

jjwt-0.9.1 在生成签名时，需要调用 javax.xml.bind.DatatypeConverter.printBase64Binary(...) 做 Base64 编码。

JDK 9+ 开始 JAXB（java.xml.bind）被移出默认类路径，于是出现
java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter。

一句话：老版本 jjwt 依赖了 JDK 8 自带、但 JDK 9+ 不再默认提供的 JAXB API。

最简修复方案（继续使用 jjwt-0.9.x）

在 pom.xml 把 JAXB 显式加回来：

xml 复制代码

<!-- 适用于 JDK 9/11/17/21 -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<!-- 如果还缺实现，再加一个实现包 -->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.9</version>
</dependency>

刷新 Maven → 重启 → DatatypeConverter 能找到，异常消失。

根治方案（推荐）

jjwt-0.9.1 已停止维护，官方 0.10+ 以后改用自己实现的 Base64，彻底去掉 JAXB 依赖。

升级依赖（Spring Boot 3.x 示例，jjwt 0.12.5）

xml 复制代码

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

工具类微调（API 变化）

java 复制代码

// 生成
String token = Jwts.builder()
        .setClaims(claims)
        .signWith(SignatureAlgorithm.HS256, jwtProperties.getAdminSecretKey().getBytes(StandardCharsets.UTF_8))
        .setExpiration(new Date(System.currentTimeMillis() + jwtProperties.getAdminTtl()))
        .compact();

// 解析
Claims claims = Jwts.parserBuilder()
        .setSigningKey(jwtProperties.getAdminSecretKey().getBytes(StandardCharsets.UTF_8))
        .build()
        .parseClaimsJws(token)
        .getBody();

升级后无论 JDK 8 还是 JDK 21 都不再需要 JAXB。

快速判断选哪种

场景	做法
项目即将下线 / 懒得改代码	加 `jaxb-api` 依赖，5 分钟搞定
长期维护 / 想跑 JDK 17+	直接升 jjwt 0.12.x（或 1.0 GA）

把依赖改完、重新打包，日志里就不会再出现 DatatypeConverter 的 ClassNotFoundException 了。