Quarkus 3.8.3迁移后出现NoClassDefFoundError: javax/xml/bind/JAXBException

你的问题核心是Quarkus 3.x基于Jakarta EE 10，默认引入Jakarta命名空间的JAXB API（jakarta.xml.bind:jakarta.xml.bind-api:4.0.1），但外部依赖仍使用Java EE的javax命名空间JAXB（javax.xml.bind:jaxb-api:2.3.1），类加载时命名空间冲突导致找不到javax.xml.bind.JAXBException。以下是优先保留javax版本的解决方案：

1. 全局排除Jakarta版本的JAXB API #

通过Maven的依赖管理，强制排除所有依赖树中的Jakarta JAXB依赖，确保只有javax版本被加载：

<dependencyManagement>
    <dependencies>
        <!-- 全局禁用Jakarta JAXB API -->
        <dependency>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
            <scope>provided</scope>
        </dependency>
        <!-- 锁定javax JAXB API版本 -->
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- 显式引入javax JAXB API -->
<dependencies>
    <dependency>
        <groupId>javax.xml.bind</groupId>
        <artifactId>jaxb-api</artifactId>
    </dependency>
</dependencies>

如果依赖管理的全局排除不生效，可以针对Quarkus核心依赖（如Hibernate、RestEasy）单独排除：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-hibernate-orm</artifactId>
    <exclusions>
        <exclusion>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy</artifactId>
    <exclusions>
        <exclusion>
            <groupId>jakarta.xml.bind</groupId>
            <artifactId>jakarta.xml.bind-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 补充JAXB运行时实现 #

Java 11及以上移除了JAXB的默认实现，必须额外引入运行时依赖，否则会出现类找不到的情况。推荐使用GlassFish的JAXB实现：

<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.1</version>
    <scope>runtime</scope>
</dependency>

3. 配置Quarkus类加载优先级 #

如果排除依赖后仍存在类加载冲突，需要让Quarkus优先加载javax的JAXB类。在src/main/resources/application.properties中添加：

quarkus.class-loading.parent-first-artifacts=javax.xml.bind:jaxb-api

该配置会强制Quarkus从父类加载器优先加载jaxb-api的类，避免与Jakarta版本的类混淆。

4. 验证依赖树 #

运行以下命令检查依赖树，确认jakarta.xml.bind:jakarta.xml.bind-api已被完全排除，只有javax.xml.bind:jaxb-api:2.3.1存在：

mvn dependency:tree | grep -E "(jaxb-api|jakarta.xml.bind)"

替代方案（仅当上述方法失效时） #

如果无法完全排除Jakarta依赖，只能修改代码将javax.xml.bind.JAXBException替换为jakarta.xml.bind.JAXBException，并使用Quarkus官方的JAXB扩展：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-jaxb</artifactId>
</dependency>

但这会放弃保留javax版本的需求，仅作为最后手段。

内容的提问来源于stack exchange，提问作者JavaEnthusiast27