Handler dispatch failed; nested exception is java.lang.NoClassDefFoundError: org/apache/poi/hssf/util/HSSFColor$HSSFColorPredefined

这个错误通常是由于缺少POI库的依赖或者版本不匹配引起的。POI是一个用于读写Microsoft Office格式文件的Java库，它提供了许多有用的API来处理Excel、Word和PowerPoint等文件。在使用POI库时，需要将其相关的依赖添加到项目中。另外，还需要确保POI库的版本与你所使用的依赖版本匹配。 如果你是使用Maven管理依赖，可以在pom.xml文件中添加如下依赖： ```xml <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>4.1.2</version> </dependency> ``` 如果你不使用Maven，则可以手动下载POI库及其依赖，并将其添加到项目的classpath中。

你遇到的异常： ``` Handler dispatch failed; nested exception is java.lang.NoClassDefFoundError: org/apache/poi/util/DefaultTempFileCreationStrategy ``` 表示你的项目在运行时找不到 `org.apache.poi.util.DefaultTempFileCreationStrategy` 这个类。 --- ## 🔍 问题分析 ### ✅ 根本原因： 这个类属于 **Apache POI** 库，是 `EasyExcel` 的底层依赖之一。出现 `NoClassDefFoundError` 表示： > **编译时有该类（或存在依赖），但运行时没有加载到对应的 jar 包** --- ## 🧰 解决方案 ### ✅ 1. 添加 Apache POI 依赖 你需要确保项目中引入了 `poi` 和 `poi-ooxml` 的依赖。如果你使用的是 Maven，添加如下依赖到 `pom.xml` 中： ```xml <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> ``` 如果你使用的是 Gradle： ```groovy implementation 'org.apache.poi:poi:5.2.3' implementation 'org.apache.poi:poi-ooxml:5.2.3' ``` --- ### ✅ 2. 检查依赖冲突 有时候虽然你添加了上述依赖，但可能被其他模块的旧版本覆盖了。你可以使用以下命令检查实际生效的依赖版本： #### Maven 用户： ```bash mvn dependency:tree ``` #### Gradle 用户： ```bash gradle dependencies ``` 查看输出中是否包含 `poi` 和 `poi-ooxml` 的正确版本。 --- ### ✅ 3. 排除冲突依赖（如有） 如果发现多个版本共存，可以排除旧版本。例如： ```xml <dependency> <groupId>some-other-library</groupId> <artifactId>xxx</artifactId> <exclusions> <exclusion> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> </exclusion> <exclusion> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> </exclusion> </exclusions> </dependency> ``` --- ## 💡 示例：Maven 完整依赖配置（EasyExcel + POI） ```xml <dependencies> <!-- EasyExcel --> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency> <!-- Apache 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> </dependencies> ``` --- ## 🧪 DefaultTempFileCreationStrategy 是什么？ 这是 Apache POI 用于临时文件管理的类，主要用于处理大文件导出时的内存优化问题。当使用模板导出、大数据量写入等操作时，POI 会用它来创建临时文件缓存数据。 如果你在使用 EasyExcel 写入大数据量或使用复杂模板，就可能会触发此类的加载。 --- ## ✅ 总结解释 | 原因 | 描述 | 解决方法 | |------|------|----------| | 缺少 poi 依赖 | 编译时有，运行时无 | 添加 `poi` 和 `poi-ooxml` 依赖 | | 版本冲突 | 多个版本共存导致类加载失败 | 使用 `mvn dependency:tree` 或 `gradle dependencies` 查看并排除冲突 | | 类未被正确打包 | 构建过程中遗漏了某些依赖 | 清理构建工具缓存并重新打包部署 | ---