Apache POI OOXML报错NoSuchFieldError:Factory问题求助

问题根源 #

这个报错是类加载冲突导致的：WebLogic 12自带了旧版本的XML处理相关库（比如stax-api），而Apache POI的XSSFWorkbook依赖更高版本的XML库，WebLogic优先加载自带的旧库，导致POI无法找到新版本中才有的Factory字段。

解决方案 #

1. 统一POI依赖版本 #

确保项目中所有POI相关依赖的版本完全一致（Java 8推荐使用POI 4.x系列，比如4.1.2，5.x系列要求Java 9+）。以Maven为例，添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>4.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>4.1.2</version>
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml-schemas</artifactId>
        <version>4.1.2</version>
    </dependency>
</dependencies>

2. 配置WebLogic优先加载应用类库 #

在项目的src/main/webapp/WEB-INF/weblogic.xml中添加类加载优先级配置，强制WebLogic优先使用应用打包的库，而非自带版本：

<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                  xsi:schemaLocation="http://xmlns.oracle.com/weblogic/weblogic-web-app http://xmlns.oracle.com/weblogic/weblogic-web-app/1.7/weblogic-web-app.xsd">
    <container-descriptor>
        <prefer-application-packages>
            <!-- POI相关包 -->
            <package-name>org.apache.poi.*</package-name>
            <!-- XML处理相关包，覆盖WebLogic自带版本 -->
            <package-name>javax.xml.stream.*</package-name>
            <package-name>com.sun.xml.stream.*</package-name>
            <package-name>org.dom4j.*</package-name>
        </prefer-application-packages>
    </container-descriptor>
</weblogic-web-app>

3. 排查并排除冲突依赖 #

用Maven命令查看依赖树，找出可能引入旧版本XML库的依赖并排除：

mvn dependency:tree

比如如果有依赖引入了旧版stax-api，在对应依赖中添加排除：

<dependency>
    <groupId>某依赖组</groupId>
    <artifactId>某依赖</artifactId>
    <version>某版本</version>
    <exclusions>
        <exclusion>
            <groupId>javax.xml.stream</groupId>
            <artifactId>stax-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

验证步骤 #

重新打包部署应用，执行Workbook workbook = new XSSFWorkbook();代码，确认不再抛出NoSuchFieldError异常。

经验总结（分享给同事） #

• 企业级应用服务器（WebLogic、WebSphere等）自带大量第三方库，极易和应用依赖产生版本冲突，prefer-application-packages是解决这类问题的通用方案
• Apache POI的所有组件（poi、poi-ooxml、poi-ooxml-schemas等）必须使用完全一致的版本，否则会出现字段缺失、类找不到等诡异错误
• 遇到NoSuchFieldError、NoClassDefFoundError时，优先排查依赖版本一致性和类加载顺序，这是Java EE环境下最常见的问题根源

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