<think>我们面临的问题是：在引入 `easypoi
-spring
-boot
-starter` 依赖后，原本正常的 EasyExcel 导出功能失效。这通常是由于两个库所依赖的 POI 版本冲突导致的。
解决思路：
1
. 排除 easypoi 引入的旧版本 POI 依赖。
2
. 确保项目中使用的 POI 版本与 EasyExcel 兼容（EasyExcel 4
.0
.3 需要 POI
5.2+）。
3
. 检查是否还有其他冲突的依赖。
具体步骤：
步骤1：使用 Maven 命令查看依赖树，找出冲突的 POI 版本
在项目根目录下执行：
```bash
mvn dependency:tree
-Dincludes=org
.apache
.poi
```
步骤2：在 pom
.xml 中排除 easypoi 引入的旧版 POI
```xml
<dependency>
<groupId>cn
.afterturn</groupId>
<artifactId>easypoi
-spring
-boot
-starter</artifactId>
<version>${easy
-poi
-version}</version>
<exclusions>
<!
-- 排除 easypoi 自带的旧版 POI
-->
<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>
```
步骤3：显式引入与 EasyExcel 兼容的 POI 版本
注意：EasyExcel 4
.0
.3 要求 POI 版本至少为
5.2
.0，因此我们引入 POI
5.2
.3（目前较新的稳定版本）。
```xml
<!
-- 统一 POI 版本
-->
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi</artifactId>
<version>
5.2
.3</version>
</dependency>
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi
-ooxml</artifactId>
<version>
5.2
.3</version>
</dependency>
```
步骤4：确保 EasyExcel 没有排除我们引入的 POI 版本（一般不需要特别处理，因为上面已经统一了版本）
步骤
5：验证依赖
再次运行 `mvn dependency:tree
-Dincludes=org
.apache
.poi`，确保所有 POI 相关依赖都指向
5.2
.3。
步骤6：如果问题仍然存在，考虑是否有其他依赖引入了旧版 POI，继续排除。
步骤7：清理并重新构建项目
执行 `mvn clean install`，然后重启应用。
步骤8：测试 EasyExcel 导出功能是否恢复。
注意事项：
- 如果项目中同时使用 EasyExcel 和 EasyPOI，请注意它们各自的兼容性。EasyPOI 可能对 POI 版本有特定要求，需要确认
5.2
.3 是否满足。
- 如果 EasyPOI 的功能因为升级 POI 而出现问题，可能需要调整 EasyPOI 的版本。
示例：完整的依赖配置
```xml
<!
-- EasyExcel
-->
<dependency>
<groupId>com
.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>4
.0
.3</version>
</dependency>
<!
-- EasyPOI with exclusions
-->
<dependency>
<groupId>cn
.afterturn</groupId>
<artifactId>easypoi
-spring
-boot
-starter</artifactId>
<version>4
.4
.0</version> <!
-- 请根据实际填写版本
-->
<exclusions>
<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 版本
-->
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi</artifactId>
<version>
5.2
.3</version>
</dependency>
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi
-ooxml</artifactId>
<version>
5.2
.3</version>
</dependency>
```
如果按照上述步骤操作后问题仍然存在，请检查错误日志，常见的冲突错误如 `NoSuchMethodError`, `NoClassDefFoundError` 等，这些错误会指明具体的类，从而帮助我们进一步定位冲突。
另外，可以尝试在代码中输出当前使用的 POI 版本：
```java
System
.out
.println("POI Version: " + org
.apache
.poi
.util
.POILogger
.class
.getPackage()
.getImplementationVersion());
```
相关问题：
1
. 如何检查 Maven 项目中依赖冲突？
2
. 如何解决 Spring Boot 项目中的依赖冲突？
3
. EasyExcel 和 EasyPOI 可以同时使用吗？
4
. 升级 POI 版本后 EasyPOI 出现不兼容问题怎么办？</think>### 解决 EasyExcel 导出功能与 easypoi
-spring
-boot
-starter 依赖冲突方案
#### 问题根源分析
当引入 `easypoi
-spring
-boot
-starter` 后，EasyExcel 导出功能失效的根本原因是 **POI 依赖版本冲突**：
1
. EasyExcel 4
.0
.3 需要 POI
5.2+ 版本[^1]
2
. easypoi
-spring
-boot
-starter 默认绑定旧版 POI (如 3
.17)
3
. 两者同时存在时，Maven 可能加载
低版本 POI，导致 EasyExcel 核心类缺失[^2]
#### 解决方案（分步操作）
##### 1
. 排除 easypoi 的旧版 POI 依赖
```xml
<dependency>
<groupId>cn
.afterturn</groupId>
<artifactId>easypoi
-spring
-boot
-starter</artifactId>
<version>${easy
-poi
-version}</version>
<!
-- 关键：排除冲突的 POI 依赖
-->
<exclusions>
<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>
```
##### 2
. 显式声明兼容的 POI 版本
```xml
<!
-- 统一 POI 版本（需与 EasyExcel 兼容）
-->
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi</artifactId>
<version>
5.2
.3</version> <!
-- EasyExcel 4
.0
.3 兼容版本
-->
</dependency>
<dependency>
<groupId>org
.apache
.poi</groupId>
<artifactId>poi
-ooxml</artifactId>
<version>
5.2
.3</version>
</dependency>
```
##### 3
. 验证依赖树
执行命令检查 POI 版本一致性：
```bash
mvn dependency:tree
-Dincludes=org
.apache
.poi
```
正常输出应显示统一版本：
```
[INFO] | \
- org
.apache
.poi:poi:jar:
5.2
.3:compile
[INFO] | \
- org
.apache
.poi:poi
-ooxml:jar:
5.2
.3:compile
```
##### 4
. 代码层检查（可选）
在启动类添加版本验证：
```java
@SpringBootApplication
public class Application {
public static void main(String[] args) {
// 检查实际加载的 POI 版本
System
.out
.println("POI Version: "
+ org
.apache
.poi
.util
.POILogger
.class
.getPackage()
.getImplementationVersion());
SpringApplication
.run(Application
.class, args);
}
}
```
#####
5. 清理构建缓存
```bash
mvn clean install
-U #
-U 强制更新快照依赖
```
#### 冲突排查技巧
若仍报错（如 `NoSuchMethodError`），使用以下诊断：
1
. **依赖分析**：
```bash
mvn dependency:analyze
```
2
. **查看冲突来源**：
```bash
mvn dependency:tree
-Dverbose
-Dincludes=org
.apache
.poi
```
3
. **错误日志分析**：
- `java
.lang
.NoSuchMethodError`：方法签名不匹配
- `java
.lang
.NoClassDefFoundError`：类加载失败
#### 兼容性说明
| 组件 | 推荐版本 | POI 要求 |
|
---------------------|
------------|
--------------|
| EasyExcel 4
.0
.3 | 固定 | POI ≥
5.2
.0 |
| easypoi
-spring
-boot | ≥ 4
.4
.0 | POI ≥
5.2
.0 |
> 📌 若必须使用旧版 easypoi（如 3
.x），建议放弃共存方案，隔离为两个独立服务[^3]。
#### 相关问题
1
. 如何在不移除 easypoi 的情况下使用 EasyExcel 的导入功能？
2
. 百万级数据导出应该选择 EasyExcel 还是 EasyPOI？
3
. 升级 POI 版本后出现 `SXSSFWorkbook` 初始化错误如何解决？
4
. Spring Boot 项目中如何全局管理 POI 版本？
[^1]: POI
5.2+ 的模块化改造导致与旧版二进制不兼容
[^2]: Maven 依赖调解优先选择最短路径或先声明的依赖
[^3]: 同时使用两种 Excel 工具可能导致内存模型冲突
扫一扫
5457
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
