Apache POI 依赖版本冲突导致 NoSuchFieldError: Factory 报错

bash 复制代码
> mvn dependency:tree   -Dincludes=org.apache.poi
.....
[INFO]       +- org.apache.poi:poi:jar:4.1.2:compile
[INFO]       +- org.apache.poi:poi-ooxml:jar:4.1.2:compile
[INFO]       +- org.apache.poi:poi-scratchpad:jar:4.1.2:compile
[INFO]       +- org.apache.poi:poi-ooxml-schemas:jar:4.1.2:compile
[INFO]       \- org.apache.poi:ooxml-schemas:jar:1.4:compile
[INFO] 

当前项目的问题已经完全清晰了:Apache POI 依赖版本严重冲突,直接导致了 NoSuchFieldError: Factory 报错。


问题分析:同时引入了 4.1.2 和 5.3.0 的 POI 版本

你打印的依赖树显示:

来自手动添加的依赖(或较新服务模块):

text 复制代码
org.apache.poi:poi-excelant:jar:5.3.0

来自 microservice-api 的传递依赖:

text 复制代码
org.apache.poi:poi:jar:4.1.2
org.apache.poi:poi-ooxml:jar:4.1.2
org.apache.poi:poi-scratchpad:jar:4.1.2
org.apache.poi:poi-ooxml-schemas:jar:4.1.2
org.apache.poi:ooxml-schemas:jar:1.4

这会导致最终运行时 不同版本的类混用 ,例如你代码是基于 5.3.0 写的,但运行时加载的是 4.1.2 的 XSSFWorkbook.class,因此报如下错:

text 复制代码
Exception in thread "main" java.lang.NoSuchFieldError: Factory
	at org.apache.poi.xssf.usermodel.XSSFWorkbook.onWorkbookCreate(XSSFWorkbook.java:508)

正确解决方案:排除旧版本,统一使用 POI 5.3.0

你应该在主项目的 pom.xml 中添加 <dependencyManagement> 或 <exclusions>,强制统一为 5.3.0。


方法一:在 pom.xml 中显式排除旧版本 poi 依赖

xml 复制代码
<dependency>
    <groupId>com.example.microservice.service</groupId>
    <artifactId>microservice-api</artifactId>
    <version>1.0-SNAPSHOT</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml-schemas</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-scratchpad</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>ooxml-schemas</artifactId>
        </exclusion>
    </exclusions>
</dependency>

方法二:用 dependencyManagement 统一版本(推荐)

xml 复制代码
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi</artifactId>
            <version>5.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml</artifactId>
            <version>5.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-excelant</artifactId>
            <version>5.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-scratchpad</artifactId>
            <version>5.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml-schemas</artifactId>
            <version>5.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.apache.xmlbeans</groupId>
            <artifactId>xmlbeans</artifactId>
            <version>5.2.1</version>
        </dependency>
    </dependencies>
</dependencyManagement>

然后只在你项目中声明依赖即可,不必重复指定版本。


最后一步:执行清理与重编译

bash 复制代码
# 清除旧缓存
rm -rf ~/.m2/repository/org/apache/poi

# 然后重新构建
mvn clean install

总结

项 结论
错误原因 poi:5.3.0 与 poi:4.1.2 冲突,导致 XSSFWorkbook 类结构不一致
根源 microservice-api 引入了旧版本 POI
解决方案 在 <dependency> 中排除旧版本,或通过 <dependencyManagement> 强制版本统一
必须操作 mvn clean install 清理旧缓存,确保生效
相关推荐
星落梦生14 小时前
SpringAOP基础笔记(7)
java·开发语言
金銀銅鐵15 小时前
带您看懂字节码指令(四):一条指令里有什么
java·jvm
最强小杰15 小时前
某 OpenAI 兼容网关上的 `kimi-k3.1-pro`:Cline、Zed 接入与 SSE 排错示例
java·服务器·网络·ai
Flynn Liang16 小时前
流量治理不是限流那么简单:I/O 密集型 Java 服务的 6 层防线
java·微服务·高并发·限流·熔断·系统稳定性·resilience4j
学长毕设16 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
曹牧17 小时前
Java:“刷新雪崩”
java·开发语言
秋天的怀念_David17 小时前
算法一千零一夜 · 第三十三夜 · 跳表
java·程序人生·算法
Forget the Dream18 小时前
Spring AI 2.0 系列(二):第一个 ChatClient——从注入到一次完整调用
java·人工智能·spring boot·ai·springai
黑十20 小时前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
神明不懂浪漫20 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记