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

Question

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

JAXB 类从 Java 6 开始作为 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"
}