JBOSS环境下Apache POI报NoClassDefFoundError问题求助

在使用Apache POI 5.2.2创建Workbook对象处理输入流时，抛出以下错误：

java.lang.NoClassDefFoundError: Could not initialize class org.apache.poi.ooxml.util.DocumentHelper

排查后发现错误出在org.apache.poi.openxml4j.opc.internal.ContentTypeManager.parseContentTypesFile方法里的DocumentHelper.readDocument(in)行，根源是无法创建javax.xml.parsers.DocumentBuilder。移除xercesImpl依赖后问题未解决，代码在WildFly上可正常运行，但生产环境的JBOSS中失败，且此前这段代码在JBOSS上是正常运行的。项目用到的依赖包括tika-core 2.7.0、tika-parsers-standard-package 2.7.0等，相关POM依赖如下：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>5.2.2</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.2</version>
</dependency>
<dependency>
    <groupId>xerces</groupId>
    <artifactId>xercesImpl</artifactId>
    <version>2.12.2</version>
</dependency>
<dependency>
    <groupId>org.apache.tika</groupId>
    <artifactId>tika-core</artifactId>
    <version>2.7.0</version>
</dependency>
<dependency>
    <groupId>org.apache.tika</groupId>
    <artifactId>tika-parsers-standard-package</artifactId>
    <version>2.7.0</version>
</dependency>

解决方案 #

• 调整JBOSS类加载优先级
  在项目的WEB-INF目录下创建或修改jboss-deployment-structure.xml，排除JBOSS自带的XML相关模块，强制使用项目打包的依赖：

  <jboss-deployment-structure>
      <deployment>
          <exclusions>
              <module name="javax.xml.api"/>
              <module name="org.apache.xerces"/>
              <module name="org.apache.xalan"/>
          </exclusions>
      </deployment>
  </jboss-deployment-structure>
  

• 修复POI与Tika的依赖冲突
  Tika 2.7.0自带了特定版本的POI，可能和项目指定的5.2.2版本冲突。用mvn dependency:tree查看依赖树，然后在Tika依赖里排除自带的POI：

  <dependency>
      <groupId>org.apache.tika</groupId>
      <artifactId>tika-parsers-standard-package</artifactId>
      <version>2.7.0</version>
      <exclusions>
          <exclusion>
              <groupId>org.apache.poi</groupId>
              <artifactId>poi</artifactId>
          </exclusion>
          <exclusion>
              <groupId>org.apache.poi</groupId>
              <artifactId>poi-ooxml</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 检查JBOSS的XML解析配置
  打开JBOSS的standalone.xml或domain.xml，查看是否有自定义的DocumentBuilderFactory配置。如果有，要么恢复默认配置，要么明确指定使用项目中的解析器实现。

• 确认打包依赖完整性
  检查项目打包时是否将xercesImpl、xml-apis等XML解析相关依赖包含在内，避免使用provided scope，除非JBOSS提供的版本完全兼容。

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