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

更新时间：2025年11月13日 08:37:04 作者：代码怪兽大大作战

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

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版本冲突内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java中Object类的常用方法小结
Java Object 类是所有类的父类,位于 java.lang 包中,本文为大家整理了一些Object类的常用方法,感兴趣的小伙伴可以跟随小编一起学习一下
2025-01-01
jsp、servlet前后端交互对数据处理及展示的简单实现
Servlet和JSP是Java Web开发中的两个重要概念,在Servlet和JSP中前后端交互可以通过一些方式来实现,这篇文章主要给大家介绍了关于jsp、servlet前后端交互对数据处理及展示的简单实现,需要的朋友可以参考下
2023-12-12
Spring Validation中9个数据校验工具使用指南
Spring Validation作为Spring生态系统的重要组成部分,提供了一套强大而灵活的数据校验机制,本文给大家介绍了Spring Validation中9个数据校验工具的使用指南,需要的朋友可以参考下
2025-05-05
JavaSE多线程阻塞队列实现代码
阻塞队列是一种线程安全的队列,可以用于多线程之间的数据传递和同步,下面这篇文章主要介绍了JavaSE多线程阻塞队列的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-12-12
关于SHA算法原理与常用实现方式
这篇文章主要介绍了关于SHA算法原理与常用实现方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-08-08
Java FineReport报表工具导出EXCEL的四种方式
这篇文章主要介绍了Java FineReport报表工具导出EXCEL的四种方式的相关资料,需要的朋友可以参考下
2016-03-03
springcloud feign传输List的坑及解决
这篇文章主要介绍了springcloud feign传输List的坑及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-03-03
Java实现文本编译器
这篇文章主要为大家详细介绍了Java实现文本编译器，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-04-04
Java数组的定义与使用
数组是有序的元素序列，若将有限个类型相同的变量的集合命名，那么这个名称为数组名。本文通过代码示例详细介绍了Java数组的定义和使用，对学习或工作有一定的帮助，需要的小伙伴欢迎阅读
2023-04-04
Java+EasyExcel实现文件上传功能
这篇文章主要为大家详细介绍了如何通过Java和EasyExcel实现文件上传功能，文中的示例代码讲解详细，感兴趣的小伙伴可以跟随小编一起学习一下
2023-02-02