使用docx4j与Hibernate时JAXB依赖冲突问题及解决咨询

这个问题我之前处理过，本质是JAXB实现类的加载冲突：docx4j-JAXB-Internal需要使用它自带的com.sun.xml.internal.bind.v2.runtime.JAXBContextImpl，但Hibernate引入的glassfish jaxb-runtime把com.sun.xml.bind.v2.runtime.JAXBContextImpl（少了internal）塞进了classpath，导致类加载器优先加载了后者，进而找不到docx4j专属的org.docx4j.jaxb.ri.NamespacePrefixMapper。

下面给你几个可行的解决方案，按推荐优先级排序：

1. 排除Hibernate中的JAXB Runtime依赖 #

因为docx4j-JAXB-Internal已经完整提供了所需的JAXB实现，我们可以直接把Hibernate带来的glassfish jaxb-runtime从依赖中剔除。在你的pom.xml里修改hibernate-core的依赖配置：

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.4.2</version>
    <exclusions>
        <!-- 移除Hibernate引入的glassfish JAXB Runtime -->
        <exclusion>
            <groupId>org.glassfish.jaxb</groupId>
            <artifactId>jaxb-runtime</artifactId>
        </exclusion>
        <!-- 可选：docx4j已经提供了jaxb-api v2.3.1，也可以一起排除避免重复 -->
        <exclusion>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

这样classpath里只会保留docx4j的JAXB实现，确保NamespacePrefixMapperUtils能找到正确的类。

2. 强制指定docx4j的JAXB依赖优先级 #

如果排除Hibernate的JAXB依赖会影响其他功能（虽然Hibernate通常兼容标准JAXB实现），可以通过Maven的依赖管理强制锁定docx4j的JAXB版本：

在pom.xml的<dependencyManagement>节点添加：

<dependencyManagement>
    <dependencies>
        <!-- 强制使用docx4j配套的JAXB版本 -->
        <dependency>
            <groupId>javax.xml.bind</groupId>
            <artifactId>jaxb-api</artifactId>
            <version>2.3.1</version>
        </dependency>
        <dependency>
            <groupId>org.docx4j</groupId>
            <artifactId>docx4j-JAXB-Internal</artifactId>
            <version>8.1.2</version>
        </dependency>
    </dependencies>
</dependencyManagement>

同时把docx4j-JAXB-Internal的依赖声明放在hibernate-core之前，让Maven解析时优先选择docx4j的依赖。

3. 手动指定JAXBContext工厂类 #

如果前两种方法都不适用，还可以在代码中显式指定docx4j需要的JAXBContext实现，绕过类加载的自动选择：

在调用docx4j的核心代码前，添加以下配置：

// 强制使用docx4j期望的JAXBContext工厂
System.setProperty("javax.xml.bind.JAXBContextFactory", "com.sun.xml.internal.bind.v2.ContextFactory");

或者直接通过docx4j的工具类设置：

org.docx4j.jaxb.NamespacePrefixMapperUtils.setJAXBContextFactory("com.sun.xml.internal.bind.v2.ContextFactory");

这样就能强制加载正确的JAXB实现类，解决找不到NamespacePrefixMapper的问题。

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