在模块路径或类路径上找不到 jaxb-api 的实现错误解决方案

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 文件中添加以下依赖：

    
        jakarta.xml.bind
        jakarta.xml.bind-api
        3.0.0
    
    
        org.glassfish.jaxb
        jaxb-runtime
        3.0.0
    

这些依赖包含 JAXB API 和运行时实现。

2. Gradle 项目

在你的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
    implementation 'org.glassfish.jaxb:jaxb-runtime:3.0.0'
}

这将把必要的 JAXB 库添加到你的项目中。

替代实现：EclipseLink MOXy

如果你想使用其他的 JAXB 实现，例如 EclipseLink MOXy，可以添加以下依赖：

Maven:

    
        jakarta.xml.bind
        jakarta.xml.bind-api
        3.0.0
    
    
        org.eclipse.persistence
        org.eclipse.persistence.moxy
        3.0.0
    

Gradle:

dependencies {
    implementation 'jakarta.xml.bind:jakarta.xml.bind-api:3.0.0'
    implementation 'or
g.eclipse.persistence:org.eclipse.persistence.moxy:3.0.0'
}

MOXy 配置

使用 MOXy 时，需要指定 JAXBContextFactory。在你的域类所在的包中创建一个名为 jaxb.properties 的文件，内容如下：

jakarta.xml.bind.context.factory=org.eclipse.persistence.jaxb.JAXBContextFactory

这将告诉 JAXB 使用 MOXy 作为实现。

调试技巧

• 检查 Java 版本: 确认你的 Java 版本以及它与 JAXB 库的兼容性。
• 使用依赖管理工具: 使用 Maven 的 dependency:tree 或 Gradle 的依赖任务来检查依赖是否正确包含。
• 类路径问题: 运行时确认类路径包含必要的 JAXB 库。

总结

"未找到 JAXB-API 的实现" 错误在升级到较新 Java 版本时很常见。通过添加正确的 JAXB 依赖并正确配置，可以解决这个问题，确保与现代 Java 环境的兼容性。