模块路径/类路径未找到JAXB-API实现的问题排查与版本适配

当前抛出的javax.xml.bind.JAXBException核心原因是类路径/模块路径上缺少JAXB实现，从错误栈里的ClassNotFoundException: com.sun.xml.bind.v2.ContextFactory可以确认这一点。Java 8及以前JAXB是JDK内置组件，但Java 9开始它被移出了JDK，需要手动引入依赖；另外如果同时存在javax.xml.bind和Jakarta EE的JAXB依赖，会引发类冲突，也是常见诱因。

直接在终端/命令行执行以下命令：

java -version

或者用Maven查看当前构建使用的JDK版本：

mvn -v

情况1：Java 8环境 #

在pom.xml的<dependencies>节点中添加以下JAXB相关依赖：

<!-- JAXB API -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<!-- JAXB 核心实现 -->
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.0.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.3</version>
    <scope>runtime</scope>
</dependency>
<!-- 配套依赖 -->
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>

情况2：Java 11及以上环境 #

Java 11+需要使用Jakarta EE版本的JAXB（原javax命名空间的JAXB已迁移到Jakarta），添加以下依赖：

<!-- Jakarta JAXB API -->
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
    <version>4.0.1</version>
</dependency>
<!-- Jakarta JAXB 实现 -->
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>4.0.4</version>
    <scope>runtime</scope>
</dependency>
<!-- Jakarta Activation API -->
<dependency>
    <groupId>jakarta.activation</groupId>
    <artifactId>jakarta.activation-api</artifactId>
    <version>2.1.2</version>
</dependency>

关键注意：绝对不要同时引入javax和Jakarta版本的JAXB依赖，否则会出现类加载冲突。

1. 检查项目是否有其他依赖间接引入了冲突的JAXB版本，可通过Maven命令查看依赖树：

mvn dependency:tree

若发现冲突，使用<exclusions>节点排除不需要的版本。
2. 如需让项目同时兼容Java 8和Java 11+，可使用Maven的profile功能自动切换依赖：

<profiles>
    <profile>
        <id>java-8</id>
        <activation>
            <jdk>1.8</jdk>
        </activation>
        <dependencies>
            <!-- Java 8专属JAXB依赖 -->
            <dependency>
                <groupId>javax.xml.bind</groupId>
                <artifactId>jaxb-api</artifactId>
                <version>2.3.1</version>
            </dependency>
            <dependency>
                <groupId>com.sun.xml.bind</groupId>
                <artifactId>jaxb-impl</artifactId>
                <version>2.3.3</version>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>javax.activation</groupId>
                <artifactId>activation</artifactId>
                <version>1.1.1</version>
            </dependency>
        </dependencies>
    </profile>
    <profile>
        <id>java-11-plus</id>
        <activation>
            <jdk>[11,)</jdk>
        </activation>
        <dependencies>
            <!-- Java 11+专属Jakarta JAXB依赖 -->
            <dependency>
                <groupId>jakarta.xml.bind</groupId>
                <artifactId>jakarta.xml.bind-api</artifactId>
                <version>4.0.1</version>
            </dependency>
            <dependency>
                <groupId>com.sun.xml.bind</groupId>
                <artifactId>jaxb-impl</artifactId>
                <version>4.0.4</version>
                <scope>runtime</scope>
            </dependency>
            <dependency>
                <groupId>jakarta.activation</groupId>
                <artifactId>jakarta.activation-api</artifactId>
                <version>2.1.2</version>
            </dependency>
        </dependencies>
    </profile>
</profiles>

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