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

> 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 版本

你打印的依赖树显示：

来自手动添加的依赖（或较新服务模块）：

org.apache.poi:poi-excelant:jar:5.3.0

来自 microservice-api 的传递依赖：

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，因此报如下错：

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 中添加 或 ，强制统一为 5.3.0。

---

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

<dependency>
    <groupId>com.example.microservice.servicegroupId>
    <artifactId>microservice-apiartifactId>
    <version>1.0-SNAPSHOTversion>
    <exclusions>
        <exclusion>
            <groupId>org.apache.poigroupId>
            <artifactId>poiartifactId>
        exclusion>
        <exclusion>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-ooxmlartifactId>
        exclusion>
        <exclusion>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-ooxml-schemasartifactId>
        exclusion>
        <exclusion>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-scratchpadartifactId>
        exclusion>
        <exclusion>
            <groupId>org.apache.poigroupId>
            <artifactId>ooxml-schemasartifactId>
        exclusion>
    exclusions>
dependency>

---

方法二：用 dependencyManagement 统一版本（推荐）

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.apache.poigroupId>
            <artifactId>poiartifactId>
            <version>5.3.0version>
        dependency>
        <dependency>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-ooxmlartifactId>
            <version>5.3.0version>
        dependency>
        <dependency>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-excelantartifactId>
            <version>5.3.0version>
        dependency>
        <dependency>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-scratchpadartifactId>
            <version>5.3.0version>
        dependency>
        <dependency>
            <groupId>org.apache.poigroupId>
            <artifactId>poi-ooxml-schemasartifactId>
            <version>5.3.0version>
        dependency>
        <dependency>
            <groupId>org.apache.xmlbeansgroupId>
            <artifactId>xmlbeansartifactId>
            <version>5.2.1version>
        dependency>
    dependencies>
dependencyManagement>

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

---

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

# 清除旧缓存
rm -rf ~/.m2/repository/org/apache/poi

# 然后重新构建
mvn clean install

---

总结

项	结论
错误原因	poi:5.3.0 与 poi:4.1.2 冲突，导致 XSSFWorkbook 类结构不一致
根源	microservice-api 引入了旧版本 POI
解决方案	在 中排除旧版本，或通过 强制版本统一
必须操作	mvn clean install 清理旧缓存，确保生效