java - 如何解决java.lang.NoClassDefFoundError : javax/xml/bind/JAXBException

Question

我有一些使用 JAXB API 类的代码，这些类已作为 Java 6/7/8 中 JDK 的一部分提供。当我使用 Java 9 运行相同的代码时，在运行时出现错误，指示找不到 JAXB 类。

从 Java 6 开始，JAXB 类就作为 JDK 的一部分提供，那么为什么 Java 9 不再能找到这些类呢？

Answer 1

JAXB API 被视为 Java EE API，因此不再包含在 Java SE 9 中的默认类路径中。在 Java 11 中，它们已从 JDK 中完全删除。

Java 9 引入了模块的概念，默认情况下，java.se 聚合模块在类路径(或者更确切地说，模块路径)上可用。顾名思义，java.se 聚合模块不包含传统上与 Java 6/7/8 捆绑在一起的 Java EE API。

幸运的是，JDK 6/7/8 中提供的这些 Java EE API 仍然在 JDK 中，但默认情况下它们不在类路径中。以下模块提供了额外的 Java EE API:

java.activation
java.corba
java.transaction
java.xml.bind  << This one contains the JAXB APIs
java.xml.ws
java.xml.ws.annotation

快速但肮脏的解决方案:(仅限 JDK 9/10)

要使 JAXB API 在运行时可用，请指定以下命令行选项:

--add-modules java.xml.bind

但是我仍然需要它才能与 Java 8 一起工作!!!

如果您尝试使用较旧的 JDK 指定 --add-modules，它会崩溃，因为它是一个无法识别的选项。我建议选择以下两个选项之一:

1. 您可以使用 JDK_JAVA_OPTIONS 环境变量设置任何仅限 Java 9+ 的选项。对于 Java 9+，此环境变量是 java 启动器的 automatically read。
2. 您可以添加-XX:+IgnoreUnrecognizedVMOptions来让JVM默默地忽略无法识别的选项，而不是崩溃。但要小心! JVM 将不再为您验证您使用的任何其他命令行参数。此选项适用于 Oracle/OpenJDK 以及 IBM JDK(从 JDK 8sr4 开始)。

<小时/>

替代快速解决方案:(仅限 JDK 9/10)

请注意，您可以通过指定 --add-modules java.se.ee 选项使上述所有 Java EE 模块在运行时可用。 java.se.ee 模块是一个聚合模块，包含 java.se.ee 以及上述 Java EE API 模块。请注意，这在 Java 11 上不起作用，因为 java.se.ee 在 Java 11 中已被删除。

<小时/>

正确的长期解决方案:(JDK 9 及更高版本)

上面列出的 Java EE API 模块都被标记为 @Deprecated(forRemoval=true) 因为它们是 scheduled for removal 中的 Java 11 。因此，--add-module 方法将不再在 Java 11 中开箱即用。

在 Java 11 及更高版本中，您需要做的是将您自己的 Java EE API 副本包含在类路径或模块路径中。例如，您可以将 JAX-B API 添加为 Maven 依赖项，如下所示:

<!-- API, java.xml.bind module -->
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>2.3.2</version>
</dependency>

<!-- Runtime, com.sun.xml.bind module -->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.2</version>
</dependency>

有关 JAXB 的更多详细信息，请参阅 JAXB Reference Implementation page。

有关 Java 模块化的完整详细信息，请参阅 JEP 261: Module System

截至 2022 年 7 月，bind-api 和 jaxb-runtime 的最新版本为 4.0.0。所以你也可以使用

    <version>4.0.0</version>

...在这些依赖子句中。但如果您这样做，包名称就会从 javax.xml.bind... 更改为 jakarta.xml.bind...。您将需要修改源代码才能使用这些更高版本的 JAR。

对于 Gradle 或 Android Studio 开发人员:(JDK 9 及更高版本)

将以下依赖项添加到您的 build.gradle 文件中:

dependencies {
    // JAX-B dependencies for JDK 9+
    implementation "jakarta.xml.bind:jakarta.xml.bind-api:2.3.2"
    implementation "org.glassfish.jaxb:jaxb-runtime:2.3.2"
}