Java项目打包成JAR后报错？EasyExcel替换Hutool的完整指南

原创

于 2026-02-25 15:17:29 发布 · 862 阅读

标签

Java项目从Hutool迁移到EasyExcel的完整实践指南

在Java开发中，处理Excel文件是常见的需求。Hutool和EasyExcel都是流行的Java Excel操作工具，但当项目打包成JAR后，Hutool可能会遇到各种依赖问题。本文将详细介绍如何从Hutool平滑迁移到EasyExcel，解决打包报错问题，并提供完整的代码示例和最佳实践。

1. 为什么需要从Hutool迁移到EasyExcel？

Hutool是一个优秀的Java工具库，其Excel模块封装了POI的操作，简化了API。但在实际使用中，特别是打包部署时，经常会遇到以下典型问题：

Exception in thread "main" cn.hutool.poi.exceptions.POIException: IOException: Your InputStream was neither an OLE2 stream, nor an OOXML stream or you haven't provide the poi-ooxml*.jar in the classpath/modulepath

这个错误的根本原因是Hutool对POI的依赖管理不够完善，导致：

依赖冲突：项目中可能存在多个POI版本
打包遗漏：部分POI依赖未正确打包进JAR
资源加载问题：Excel文件流处理方式不够健壮

相比之下，EasyExcel具有以下优势：

更低的内存消耗：采用SAX模式解析，避免OOM
更好的兼容性：对POI依赖做了精细控制
更简洁的API：读写模型更符合现代Java习惯
更活跃的维护：阿里巴巴团队持续更新

2. 迁移前的准备工作

2.1 环境检查

在开始迁移前，请确认以下环境信息：

# Java版本检查
java -version

# Maven版本检查
mvn -v

# 当前项目依赖树
mvn dependency:tree > dependencies.txt

2.2 依赖清理

首先需要清理原有的Hutool和POI依赖。在pom.xml中：

<!-- 移除以下依赖 -->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.20</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi</artifactId>
    <version>${poi.version}</version>
</dependency>
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>${poi.version}</version>
</dependency>