###
JDK 17 中 `
NoClassDefFoundError` 导致 `
javax.xml.bind.DatatypeConverter` 缺失的原因
在
Java 9 及其后续版本中，为了实现更清晰的模块化设计，
Java 平台进行了重大的结构调整。作为这一调整的一部分，许多原本属于
Java SE 的功能被移至独立的模块或完全从标准库中删除。其中就包括 JAXB (
Java Architecture for
XML Binding) API 和相关类，例如 `
javax.xml.bind.DatatypeConverter`。
由于这些类是从
Java EE 模块分离出来的，在
Java 9 或更新版本（如
JDK 17）中默认不再提供支持[^4]。当应用程序尝试加载此类时，如果未显式引入相应的依赖项，则会抛出 `
java.lang
.NoClassDefFoundError` 或 `ClassNotFoundException` 异常。
---
### 解决方案
#### 方法一：通过 Maven 添加 JAXB API 依赖
要解决此问题，可以将 JAXB API 显式添加到
项目的构建工具配置文件中。对于基于 Maven 的
项目，需在 `pom
.xml` 文件中加入以下依赖：
```
xml
<dependency>
<groupId>jakarta
.xml.bind</groupId>
<artifactId>jakarta
.xml.bind-api</artifactId>
<version>4
.0
.0</version>
</dependency>
<dependency>
<groupId>com
.sun
.xml.bind</groupId>
<artifactId>jaxb
-impl</artifactId>
<version>4
.0
.0</version>
</dependency>
```
上述代码片段中的两个依赖分别提供了 JAXB 接口定义以及其实现逻辑[^3]。注意这里使用的是 Jakarta 命名空间下的最新版本，适用于较新的
JDK 版本。
#### 方法二：手动下载并导入 JAR 包
如果不采用自动化构建工具管理外部库，也可以直接获取对应的 `
.jar` 文件并将它们放置于应用
运行路径下。可以从 Maven Central Repository 下载所需组件，并将其添加到
项目的 classpath 中。
#### 方法三：降级
JDK 版本
虽然不推荐这种做法，但如果短期内无法迁移现有代码来兼容新环境的话，可以选择回退到较低版本的
JDK （比如
JDK 8），因为该版本仍然内置了完整的 JAXB 支持[^5]。
不过需要注意的是长期维持旧版软件可能存在安全风险等问题，所以仅应视作临时过渡措施而非最终解决方案。
---
### 示例代码验证修复效果
假设我们有一个简单的测试程序如下所示
:
```
java
import
javax.xml.bind.DatatypeConverter;
public class Test
DatatypeConverter {
public static void main(String[] args) {
String encodedString =
DatatypeConverter.printBase64Binary("Test"
.getBytes());
System
.out
.println(encodedString);
byte[] decodedBytes =
DatatypeConverter.parseBase64Binary(encodedString);
System
.out
.println(new String(decodedBytes));
}
}
```
按照前述任一种方式补充必要的依赖之后重新编译执行以上脚本就不会再遭遇缺少 `
DatatypeConverter` 类的情况发生。
---
扫一扫
1313
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
