Java XML 绑定架构 (JAXB) 相关的 javax.xml.bind.JAXBException: Implementation of JAXB-API has not been found on module path or classpath 错误，通常发生在 Java 9 及更高版本中使用 JAXB 的应用程序。这是因为从 Java 9 开始，JAXB API 已被移除，不再包含在 JDK 中。
问题根源
Java 9 之后，JAXB API 从 JDK 中移除，因此依赖 JAXB 的项目必须手动添加必要的库。
解决方案
解决方法是为你的项目添加相应的 JAXB 依赖。具体操作取决于你使用的构建工具：
1. Maven 项目
在你的 pom.xml 文件中添加以下依赖：
<code class="xml"><dependencies>
<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>org.glassfish.jaxb</groupId>
<artifactId>jaxb-runtime</artifactId>
<version>3.0.0</version>
</dependency>
</dependencies></code>
这些依赖包含 JAXB API 和运行时实现。
2. Gradle 项目
在你的 build.gradle 文件中添加以下依赖：
<code class="gradle">dependencies {
implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
implementation 'org.glassfish.jaxb:jaxb-runtime:3.0.0'
}</code>
这将把必要的 JAXB 库添加到你的项目中。
替代实现：EclipseLink MOXy
如果你想使用其他的 JAXB 实现，例如 EclipseLink MOXy，可以添加以下依赖：
Maven:
<code class="xml"><dependencies>
<dependency>
<groupId>jakarta.xml.bind</groupId>
<artifactId>jakarta.xml.bind-api</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>org.eclipse.persistence</groupId>
<artifactId>org.eclipse.persistence.moxy</artifactId>
<version>3.0.0</version>
</dependency>
</dependencies></code>
Gradle:
<code class="gradle">dependencies {
implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
implementation 'org.eclipse.persistence:org.eclipse.persistence.moxy:3.0.0'
}</code>
MOXy 配置
使用 MOXy 时，需要指定 JAXBContextFactory。在你的域类所在的包中创建一个名为 jaxb.properties 的文件，内容如下：
<code class="properties">jakarta.xml.bind.context.factory=org.eclipse.persistence.jaxb.JAXBContextFactory</code>
这将告诉 JAXB 使用 MOXy 作为实现。
调试技巧
- 检查 Java 版本: 确认你的 Java 版本以及它与 JAXB 库的兼容性。
-
使用依赖管理工具: 使用 Maven 的
dependency:tree或 Gradle 的依赖任务来检查依赖是否正确包含。 - 类路径问题: 运行时确认类路径包含必要的 JAXB 库。
总结
"未找到 JAXB-API 的实现" 错误在升级到较新 Java 版本时很常见。通过添加正确的 JAXB 依赖并正确配置，可以解决这个问题，确保与现代 Java 环境的兼容性。
