使用JAXB解析XML时初始化JAXBContext抛出异常求助

你遇到的问题本质是JAXB API的版本迁移冲突，再加上Java版本迭代带来的依赖缺失问题，下面我一步步给你拆解解决方案：

一、问题根源拆解 #

• Java 8及更早版本：JAXB是JDK内置组件，无需额外依赖；但从Java 9开始，JAXB被移出了JDK核心模块，必须手动引入完整依赖。
• 目前JAXB已经从Java EE迁移到Jakarta EE生态，API包名从javax.xml.bind彻底变更为jakarta.xml.bind。如果混用这两套API和实现类，必然会出现类加载冲突（ClassCastException）或类找不到（NoClassDefFoundError）的问题。

二、解决方案步骤 #

1. 选择统一的依赖体系（二选一，优先推荐Jakarta） #

方案A：使用最新Jakarta EE版本（长期维护，推荐新代码使用）

这是官方当前主推的版本，后续会持续更新维护。

POM依赖配置：

<dependencies>
    <!-- Jakarta JAXB核心API -->
    <dependency>
        <groupId>jakarta.xml.bind</groupId>
        <artifactId>jakarta.xml.bind-api</artifactId>
        <version>4.0.2</version> <!-- 可替换为最新稳定版 -->
    </dependency>
    <!-- JAXB实现类（默认用Eclipse MOXy，也可以替换为GlassFish实现） -->
    <dependency>
        <groupId>org.eclipse.persistence</groupId>
        <artifactId>org.eclipse.persistence.moxy</artifactId>
        <version>4.0.2</version>
        <scope>runtime</scope>
    </dependency>
    <!-- 若选择GlassFish实现，替换上面的MOXy依赖 -->
    <!--
    <dependency>
        <groupId>org.glassfish.jaxb</groupId>
        <artifactId>jaxb-runtime</artifactId>
        <version>4.0.2</version>
        <scope>runtime</scope>
    </dependency>
    -->
</dependencies>

代码与配置调整：

• 所有相关导入包替换为jakarta.xml.bind，比如：

  import jakarta.xml.bind.JAXBContext;
  import jakarta.xml.bind.JAXBException;
  import jakarta.xml.bind.Unmarshaller;
  

• 若使用jaxb.properties文件，内容需对应Jakarta的实现类：

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

方案B：使用旧Java EE版本（仅兼容遗留代码）

如果你必须维护基于javax.xml.bind的旧代码，要确保所有依赖都属于javax体系，绝对不能混入jakarta包。

POM依赖配置：

<dependencies>
    <!-- 旧版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-impl</artifactId>
        <version>2.3.1</version>
        <scope>runtime</scope>
    </dependency>
    <!-- 必要的激活API依赖 -->
    <dependency>
        <groupId>javax.activation</groupId>
        <artifactId>activation</artifactId>
        <version>1.1.1</version>
    </dependency>
</dependencies>

代码与配置调整：

• 保持导入javax.xml.bind相关包不变。
• jaxb.properties文件内容：

  javax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory
  

2. 排查并解决依赖冲突 #

执行Maven命令查看完整依赖树，检查是否存在javax/jakarta混合依赖的情况：

mvn dependency:tree

如果发现冲突依赖（比如同时存在jakarta.xml.bind-api和jaxb-api），使用<exclusions>标签手动排除不需要的依赖。

3. Java版本适配 #

• Java 8：可以选择方案B，也可以用方案A（需确保依赖完整）；
• Java 9+：必须手动引入完整JAXB依赖（JDK已移除内置JAXB），如果是模块化项目，需要在module-info.java中声明依赖：requires jakarta.xml.bind.api;。

三、验证步骤 #

1. 清理Maven缓存并重新下载依赖：mvn clean install -U
2. 检查所有Java类的导入包是否完全统一（全jakarta或全javax）
3. 确认jaxb.properties文件放在实体类所在的包路径下
4. 重新运行程序，验证异常是否消失

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