EasyExcel导出Excel时NoSuchMethodError异常分析与解决方案

问题背景

在使用阿里巴巴开源的EasyExcel库进行Excel文件导出时，开发者可能会遇到NoSuchMethodError异常，具体表现为ZipArchiveOutputStream.putArchiveEntry方法找不到。这类问题通常与依赖版本冲突有关，特别是在同时使用多个Office处理库时。

异常现象

当尝试使用EasyExcel导出Excel文件时，控制台会抛出以下异常堆栈：

com.alibaba.excel.exception.ExcelGenerateException: Can not close IO.
Caused by: java.lang.NoSuchMethodError: org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream.putArchiveEntry(Lorg/apache/commons/compress/archivers/zip/ZipArchiveEntry;)V

根本原因分析

这个问题的根本原因是项目中存在多个版本的依赖库冲突，特别是：

1. Apache POI版本冲突：EasyExcel底层依赖Apache POI处理Excel文件，当项目中显式引入的POI版本与EasyExcel内置版本不一致时，会导致方法签名不匹配。

2. commons-compress库缺失或版本不兼容：ZipArchiveOutputStream类属于commons-compress库，该库是POI的间接依赖。当版本不匹配时，会出现方法找不到的错误。

3. 依赖传递问题：项目中同时使用了EasyExcel、POI和poi-tl等多个Office处理库，这些库对依赖版本的要求可能存在冲突。

解决方案

经过验证，以下依赖配置可以解决该问题：

<!-- Office IO 依赖配置 -->
<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>com.deepoove</groupId>
    <artifactId>poi-tl</artifactId>
    <version>1.12.2</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.1</version>
    <exclusions>
        <exclusion>
            <groupId>org.apache.poi</groupId>
            <artifactId>poi-ooxml-schemas</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.16.1</version>
</dependency>
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-compress</artifactId>
    <version>1.27.0</version>
</dependency>

关键点说明

1. 版本对齐：确保所有POI相关依赖使用相同版本（本例中使用5.3.0）。

2. 排除冲突依赖：在EasyExcel中排除可能导致冲突的poi-ooxml-schemas。

3. 显式声明commons-compress：直接引入合适版本的commons-compress库（1.27.0），避免使用不兼容的版本。

4. commons-io版本控制：使用较新版本的commons-io（2.16.1）确保IO操作兼容性。

最佳实践建议

1. 在使用EasyExcel时，建议先了解其内置的依赖版本，避免引入冲突版本。

2. 使用Maven的dependency:tree命令检查依赖树，识别潜在的版本冲突。

3. 当项目需要同时使用多个Office处理库时，应该统一这些库所依赖的POI版本。

4. 对于生产环境，建议锁定所有相关依赖的版本号，避免因依赖升级导致的兼容性问题。

通过以上配置和注意事项，可以有效解决EasyExcel导出Excel时遇到的NoSuchMethodError异常问题，确保Excel导出功能的稳定运行。