JeecgBoot项目中POI版本冲突问题分析与解决方案

背景介绍

在JeecgBoot项目开发过程中，许多开发者会遇到Excel处理相关的技术选型问题。近期有开发者反馈在项目中尝试将EasyExcel替换为FastExcel时遇到了兼容性问题，这主要是由于项目中同时存在不同版本的Apache POI依赖导致的。

问题现象

当开发者在Spring Boot 3项目中尝试使用FastExcel替换EasyExcel时，系统抛出了NoSuchFieldError异常，提示CTWorkbook类缺少Factory成员字段。经过分析发现，这是由于项目中同时存在三个不同版本的POI相关依赖：

1. FastExcel引入的poi-ooxml:5.4.0
2. AutoPOI引入的poi-ooxml-schemas:4.1.2
3. AutoPOI引入的ooxml-schemas:1.4

根本原因

问题的核心在于不同版本的POI库中CTWorkbook类的实现不一致。在POI 5.4.0版本中，CTWorkbook类确实包含Factory方法，但在4.1.2和1.4版本中则没有这个方法。当JVM尝试加载类时，由于类路径中存在多个版本的POI库，导致了版本冲突。

解决方案

针对这个问题，开发者可以考虑以下几种解决方案：

方案一：升级AutoPOI中的POI版本

最彻底的解决方案是请求JeecgBoot团队将AutoPOI中的POI依赖升级到5.x版本，与FastExcel保持一致。这样可以消除版本冲突问题，但需要确保升级后的版本与项目其他部分兼容。

方案二：使用Maven排除冲突依赖

如果暂时无法升级AutoPOI的POI版本，可以在项目中显式排除冲突的依赖：

<dependency>
    <groupId>org.jeecgframework</groupId>
    <artifactId>autopoi</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml-schemas</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>ooxml-schemas</artifactId>
        </exclusion>
    </exclusions>
</dependency>

方案三：统一使用单一Excel处理库

考虑到版本冲突的复杂性，开发者也可以选择统一使用单一Excel处理库，如全部使用FastExcel或者全部使用EasyExcel，避免混合使用不同库带来的兼容性问题。

技术建议

在处理此类依赖冲突问题时，建议开发者：

1. 使用mvn dependency:tree命令仔细分析项目依赖树
2. 了解各Excel处理库的底层实现原理
3. 在大型项目中保持依赖版本的一致性
4. 必要时创建隔离的类加载器来处理特殊依赖

总结

JeecgBoot项目中的POI版本冲突问题是一个典型的Java依赖管理问题。通过理解问题的本质，开发者可以采取适当的解决方案，确保项目稳定运行。在开源项目中使用第三方库时，保持依赖版本的一致性是避免此类问题的关键。