首页 > 软件编程 > java > EasyExcel与Apache POI版本冲突

EasyExcel与Apache POI版本冲突导致`NoSuchMethodError`异常的解决方法

2025-11-13 08:37:05 作者：代码怪兽大大作战

本文介绍了EasyExcel与ApachePOI版本冲突导致`NoSuchMethodError`异常的原因,并提供了两种解决方案：排除EasyExcel自带的POI并手动指定统一版本,或者移除自己引入的POI,同时,也强调了在使用EasyExcel时避免单独引入POI的重要性,需要的朋友可以参考下

最近在使用 EasyExcel 导出 Excel 时，遇到了类似这样的异常：

Caused by: java.lang.NoSuchMethodError: org.apache.poi.util.StringUtil.isNotBlank(Ljava/lang/CharSequence;)Z
    at org.apache.poi.openxml4j.opc.OPCPackage.close(OPCPackage.java:462)
    at org.apache.poi.ooxml.POIXMLDocument.close(POIXMLDocument.java:189)
    at org.apache.poi.xssf.usermodel.XSSFWorkbook.close(XSSFWorkbook.java:610)
    at org.apache.poi.xssf.streaming.SXSSFWorkbook.close(SXSSFWorkbook.java:972)
    at com.alibaba.excel.context.WriteContextImpl.finish(WriteContextImpl.java:383)

这个错误在 Stack Overflow 和国内社区里都出现过很多次。

看起来像是 POI 的 bug，但其实 根本原因是 “依赖冲突 + 版本不兼容”。

一、背景：EasyExcel 与 Apache POI 的关系

阿里巴巴的 EasyExcel 是一个基于 Apache POI 封装的轻量级 Excel 操作框架。

也就是说：

EasyExcel 本身不直接操作 XLSX 文件；
它在底层依然依赖 Apache POI（poi、poi-ooxml、poi-ooxml-schemas） 来读写文件。

因此，当你的项目中出现多个 POI 版本时，很容易导致类加载冲突。

二、典型错误场景

场景一：项目中已引入了 POI，再引入 EasyExcel

举个例子：

<!-- 你自己引入的 POI -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>3.17</version>
</dependency>

<!-- 后来又加了 EasyExcel -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.3</version>
</dependency>

这时候，项目中会同时存在两套 POI 版本：

依赖来源	版本	特点
你自己的 POI	3.17	老版本，没有 `StringUtil.isNotBlank` 方法
EasyExcel 内部 POI	4.x	新版本，增加了 `isNotBlank` 方法

当 JVM 加载类时，如果先加载了旧版本的 poi，

EasyExcel 内部再去调用新版本方法（例如 StringUtil.isNotBlank(CharSequence)），

就会抛出：

NoSuchMethodError: org.apache.poi.util.StringUtil.isNotBlank(Ljava/lang/CharSequence;)Z

本质原因：运行时类加载顺序导致的 方法签名缺失。

场景二：EasyExcel 与 POI 版本不兼容

即使你只引入了 EasyExcel，一些 IDE 或父依赖（如 Spring Boot Starter）可能传递进了 不兼容版本的 POI。

例如：

EasyExcel 4.0.3 编译依赖 POI 4.1.2；
但 Spring Boot 传递进了 POI 5.2.x；
运行时会出现某些类或方法签名不匹配（比如 StringUtil.isNotBlank、POIXMLDocument.close）。

本质原因：EasyExcel 依赖的 POI 方法签名在高版本中被修改或删除。

三、解决方案

方案一：排除 EasyExcel 自带的 POI，手动指定统一版本（推荐）

<!--  EasyExcel 导出（排除内部 POI 依赖） -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.3</version>
    <exclusions>
        <exclusion>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
        </exclusion>
        <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>
    </exclusions>
</dependency>

<!--  手动指定兼容版本 POI（与 EasyExcel 4.0.3 完美匹配） -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>4.1.2</version>
</dependency>

说明：EasyExcel 4.0.3 的源码中基于 POI 4.1.x 版本构建，因此与之兼容性最佳。

方案二：如果项目不直接使用 POI，直接移除自己引入的 POI

如果你的项目只通过 EasyExcel 操作 Excel，没有直接使用 POI 的 API，

那么最简单的方式是删除多余的 POI 依赖：

<!-- 保留 EasyExcel 即可 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>easyexcel</artifactId>
    <version>4.0.3</version>
</dependency>

四、总结

问题类型	根本原因	解决方式
依赖冲突	项目中同时存在多个 POI 版本	排除 EasyExcel 内部 POI，只保留一个版本
版本不兼容	EasyExcel 与当前 POI 方法签名不同	使用与 EasyExcel 匹配的 POI 版本（如 4.1.2）

最简单的经验法则：

只用 EasyExcel → 不要单独引入 POI。
同时用 POI + EasyExcel → 统一 POI 版本并排除 EasyExcel 自带的依赖。

结语：

NoSuchMethodError 并不是 EasyExcel 的 bug，而是依赖管理的问题。
只要理清依赖树、保持 POI 版本一致，就能彻底解决此类冲突。

到此这篇关于EasyExcel与Apache POI版本冲突导致`NoSuchMethodError`异常的解决方法的文章就介绍到这了,更多相关EasyExcel与Apache POI版本冲突内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！