Maven项目中Apache POI导出XLSX依赖冲突问题求助

问题本质 #

java.lang.NoClassDefFoundError: Could not initialize class org.apache.poi.ooxml.util.DocumentHelper 是因为POI的OOXML模块（处理XLSX）与项目中的Xerces XML解析库存在类加载冲突——POI内部依赖的XML解析实现和外部引入的Xerces版本不兼容，导致DocumentHelper初始化失败。而PDF导出功能依赖Xerces，直接移除会导致PDF模块找不到所需的XML解析类，顾此失彼。

可行解决方案 #

1. 限制Xerces的依赖作用范围 #

如果PDF导出仅在运行时需要Xerces，可将其依赖范围设为runtime，避免干扰POI的类初始化流程：

<dependency>
    <groupId>xerces</groupId>
    <artifactId>xercesImpl</artifactId>
    <version>你的Xerces版本号</version>
    <scope>runtime</scope>
</dependency>

2. 排除POI依赖树中冲突的XML组件 #

POI自身依赖的xml-apis、dom4j等XML库可能与Xerces冲突，可在POI的依赖声明中排除这些组件，强制使用项目中的Xerces：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>你的POI版本号</version>
    <exclusions>
        <exclusion>
            <groupId>xml-apis</groupId>
            <artifactId>xml-apis</artifactId>
        </exclusion>
        <exclusion>
            <groupId>dom4j</groupId>
            <artifactId>dom4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 统一XML解析库版本 #

在dependencyManagement中锁定所有XML相关库的版本，避免版本不一致导致的兼容问题：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>xerces</groupId>
            <artifactId>xercesImpl</artifactId>
            <version>2.12.2</version> <!-- 推荐稳定兼容版本 -->
        </dependency>
        <dependency>
            <groupId>xml-apis</groupId>
            <artifactId>xml-apis</artifactId>
            <version>1.4.01</version>
        </dependency>
    </dependencies>
</dependencyManagement>

4. 验证依赖树 #

执行以下Maven命令，确认最终依赖树中无重复或冲突的XML解析库：

mvn dependency:tree -Dincludes=xerces,xml-apis,org.apache.poi

验证步骤 #

• 先测试XLSX导出，确认DocumentHelper初始化正常，无NoClassDefFoundError
• 再测试PDF导出，验证XML解析逻辑可正常调用Xerces类

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