easyexcel和poi版本冲突报错深入解析v2

EasyExcel 和 Apache POI 版本冲突报错深入解析

在使用 Java 处理 Excel 文件时，Apache POI 和 EasyExcel 是两个非常常用的库。Apache POI 提供了全面的 Excel 处理能力，而 EasyExcel 则专注于高效处理大数据量的 Excel 文件。然而，在同一个项目中同时引入这两个库时，可能会出现版本冲突的问题，导致运行时报错或功能异常。本文将深入分析 EasyExcel 和 POI 的版本冲突问题，并提供解决方案。

一、问题背景

1.1 Apache POI 简介

Apache POI 是一个强大的 Java 库，能够读写 Excel、Word、PowerPoint 等多种微软格式的文件。其主要模块包括：

poi：处理 HSSF（Excel 2003 及以下版本的 .xls 文件）。
poi-ooxml：处理 XSSF（Excel 2007 及以上版本的 .xlsx 文件）。
poi-ooxml-schemas：处理复杂的 OOXML 文件格式。

1.2 EasyExcel 简介

EasyExcel 是阿里巴巴开源的 Excel 读写工具，专注于高效处理大数据量的 Excel 文件。其优势在于：

内存消耗低：EasyExcel 在处理大文件时的内存占用较少。
操作简单：使用注解和简洁的 API，减少代码复杂度。

1.3 冲突原因

EasyExcel 底层依赖于 Apache POI 的部分组件，因此当项目同时依赖 EasyExcel 和 POI 时，可能会出现依赖冲突。具体问题通常表现为以下几种：

NoSuchMethodError：运行时找不到某个方法，可能是由于 POI 和 EasyExcel 使用了不同版本的同一个类。
ClassNotFoundException：找不到某个类，通常是因为版本差异导致的类路径问题。
AbstractMethodError：抽象方法的实现不一致，可能是不同版本间接口变动导致的。

二、常见的错误及原因分析

2.1 `NoSuchMethodError`

示例错误：

Exception in thread "main" java.lang.NoSuchMethodError: org.apache.poi.xssf.usermodel.XSSFWorkbook.createSheet(Ljava/lang/String;)Lorg/apache/poi/ss/usermodel/Sheet;

原因分析：

该错误通常是由于 EasyExcel 和 POI 依赖的版本不一致，导致运行时找不到特定方法。具体来说，EasyExcel 可能依赖较低版本的 POI，而项目中引入的 POI 版本较高，这导致某些方法签名发生了变化或方法被移除。

2.2 `ClassNotFoundException`

示例错误：

java.lang.ClassNotFoundException: org.apache.poi.xssf.usermodel.XSSFFont

原因分析：

该错误是由于类路径中缺少特定的类文件。EasyExcel 依赖 POI 的某些模块，如果 POI 的某些模块未被正确引入，EasyExcel 在运行时就无法找到这些类。

2.3 `AbstractMethodError`

示例错误：

java.lang.AbstractMethodError: org.apache.poi.xssf.usermodel.XSSFCellStyle.getFont()Lorg/apache/poi/ss/usermodel/Font;

原因分析：

该错误通常是由于接口发生了变更。POI 在不同版本中对某些接口或抽象类进行了修改，导致实现类与接口不兼容，从而在运行时抛出此错误。

三、解决方案

3.1 统一依赖版本

为了避免版本冲突，最简单的方法是统一 POI 和 EasyExcel 的依赖版本。在 Maven 或 Gradle 中，可以通过以下步骤来统一版本：

排除冲突的依赖：通过 exclusions 标签排除 EasyExcel 自带的 POI 依赖。

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>3.0.5</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>

手动指定 POI 版本：在项目中手动引入与 EasyExcel 兼容的 POI 版本，以确保二者使用同一版本的 POI 组件。
```
<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>
```
解释：
- 通过排除 EasyExcel 默认引入的 POI 版本，并手动指定项目中统一的 POI 版本，避免了版本不一致导致的冲突。

3.2 使用 BOM 统一管理依赖版本

如果项目依赖较多，可以使用 Maven 的 BOM（Bill of Materials）机制统一管理依赖版本。通过 BOM 可以避免手动管理每个依赖的版本号，提高项目依赖管理的一致性。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>easyexcel</artifactId>
            <version>3.0.5</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
        <dependency>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-bom</artifactId>
            <version>4.1.2</version>
            <scope>import</scope>
            <type>pom</type>
        </dependency>
    </dependencies>
</dependencyManagement>

解释：