java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook

最新推荐文章于 2023-06-08 10:49:02 发布
原创 最新推荐文章于 2023-06-08 10:49:02 发布 · 2.1w 阅读 · 5 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#poi #springboot #NoClassDefFoundError

java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook

springboot集成poi，结果报了如下错误

java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook
	at com.usoft.sschool_manage.util.excel.ExcelUtil.foodInformation(ExcelUtil.java:73) ~[classes/:na]
	at com.usoft.sschool_manage.service.UploadExcelUtil.uploadExcel(UploadExcelUtil.java:103) ~[classes/:na]
	at com.usoft.sschool_manage.controller.UploadExcelController.getExcel(UploadExcelController.java:29) ~[classes/:na]
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_172]
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_172]
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_172]
	at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_172]
	at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:189) ~[spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:138) ~[spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:102) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:892) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:797) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1038) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:942) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1005) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:908) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:661) ~[servlet-api.jar:na]
	at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:882) ~[spring-webmvc-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:742) ~[servlet-api.jar:na]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52) ~[tomcat-websocket.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:99) ~[spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.springframework.web.filter.FormContentFilter.doFilterInternal(FormContentFilter.java:92) ~[spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.springframework.web.filter.HiddenHttpMethodFilter.doFilterInternal(HiddenHttpMethodFilter.java:93) ~[spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.springframework.boot.web.servlet.support.ErrorPageFilter.doFilter(ErrorPageFilter.java:130) [spring-boot-2.1.4.RELEASE.jar:2.1.4.RELEASE]
	at org.springframework.boot.web.servlet.support.ErrorPageFilter.access$000(ErrorPageFilter.java:66) [spring-boot-2.1.4.RELEASE.jar:2.1.4.RELEASE]
	at org.springframework.boot.web.servlet.support.ErrorPageFilter$1.doFilterInternal(ErrorPageFilter.java:105) [spring-boot-2.1.4.RELEASE.jar:2.1.4.RELEASE]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.boot.web.servlet.support.ErrorPageFilter.doFilter(ErrorPageFilter.java:123) [spring-boot-2.1.4.RELEASE.jar:2.1.4.RELEASE]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:200) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107) [spring-web-5.1.6.RELEASE.jar:5.1.6.RELEASE]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) [catalina.jar:8.5.35]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) [catalina.jar:8.5.35]
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:198) [catalina.jar:8.5.35]
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:96) [catalina.jar:8.5.35]
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:493) [catalina.jar:8.5.35]
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:140) [catalina.jar:8.5.35]
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:81) [catalina.jar:8.5.35]
	at org.apache.catalina.valves.AbstractAccessLogValve.invoke(AbstractAccessLogValve.java:650) [catalina.jar:8.5.35]
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:87) [catalina.jar:8.5.35]
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:342) [catalina.jar:8.5.35]
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:800) [tomcat-coyote.jar:8.5.35]
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:66) [tomcat-coyote.jar:8.5.35]
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:806) [tomcat-coyote.jar:8.5.35]
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1498) [tomcat-coyote.jar:8.5.35]
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49) [tomcat-coyote.jar:8.5.35]
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) [na:1.8.0_172]
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) [na:1.8.0_172]
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61) [tomcat-util.jar:8.5.35]
	at java.lang.Thread.run(Thread.java:748) [na:1.8.0_172]
Caused by: java.lang.ClassNotFoundException: org.apache.poi.xssf.usermodel.XSSFWorkbook
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1328) ~[catalina.jar:8.5.35]
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1156) ~[catalina.jar:8.5.35]
	... 65 common frames omitted

。。。。我擦，居然说我的类未定义，于是我查看的相关类：

package com.usoft.sschool_manage.util.excel;


import com.usoft.smartschool.pojo.XnFood;
import com.usoft.smartschool.pojo.XnScore;
import com.usoft.smartschool.util.MyResult;
import com.usoft.smartschool.util.ObjectUtil;
import org.apache.poi.ss.usermodel.CellType;
import org.apache.poi.xssf.usermodel.XSSFCell;
import org.apache.poi.xssf.usermodel.XSSFRow;
import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.File;
import java.io.FileInputStream;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * Excel文件解析
 * @Author jijh
 * @Date 2019/5/17 11:18
 */

public class ExcelUtil {


    /**
     * 教师
     */
    private static final int TEACHER = 1;

    /**
     * 班级
     */
    private static final int CLASS = 2;

    /**
     * 课程
     */
    private static final int COURSE = 3;

    /**
     * 菜单
     */
    private static final int FOOD = 4;

    /**
     * 成绩
     */
    private static final int SCORE = 5;

    /**
     * 学生
     */
    private static final int STUDENT = 6;


    /**
     * 菜单导入
     *
     * @param schoolId
     * @param userId
     * @param file
     * @return
     */
    public static MyResult foodInformation(Integer schoolId, Integer userId, File file) {
        //workbook = null;
        try {
            FileInputStream fis = new FileInputStream(file);
            XSSFWorkbook workbook = new XSSFWorkbook(fis);
            XSSFSheet sheet = workbook.getSheetAt(0);
            int rowCount = sheet.getPhysicalNumberOfRows();
            List<XnFood> xnFoods = new ArrayList<>();
            for (int i = 1; i < rowCount; i++) {
                XSSFRow row = sheet.getRow(i);
                XnFood xnFood = new XnFood();
                xnFood.setSid(schoolId);
                for (int j = 0; j < 3; j++) {
                    XSSFCell cell = row.getCell(j);
                    switch (j) {
                        case 0: {
                            if (cell.getCellTypeEnum() != CellType.NUMERIC) {
                                if (!ObjectUtil.isEmpty(cell.getStringCellValue())) {
                                    return MyResult.failure("第" + i + "行，第" + 1 + "列数据有误");
                                } else {
                                    return MyResult.success(xnFoods);
                                }

                            } else {
                                xnFood.setWeek((int) cell.getNumericCellValue());
                            }
                        }
                        ;
                        break;
                        case 1: {
                            if (cell.getCellTypeEnum() != CellType.NUMERIC) {
                                return MyResult.failure("第" + i + "行，第" + 2 + "列数据有误");
                            } else {
                                xnFood.setFoodtime((byte) cell.getNumericCellValue());
                            }
                        }
                        ;
                        break;
                        case 2: {
                            if (cell.getCellTypeEnum() != CellType.STRING) {
                                return MyResult.failure("第" + i + "行，第" + 3 + "列数据有误");
                            } else {
                                xnFood.setFoodname(cell.getStringCellValue().trim());
                            }
                            xnFoods.add(xnFood);
                        }
                        ;
                        break;
                    }
                }

            }
            return MyResult.success(xnFoods);

        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }

}

并没有发现有什么地方有问题，于是我又去看看我的maven包有没有加入到项目里面

发现也没有问题。于是我又开始疯狂的百度。。有的说是版本不一致，但是我的都是一致的。。。。。。。

终于。整了我一天的时间。发现原来是这里没有导入包(Project Structure  --> artifacts --> 带exploded里面WEB-INF下lib没这个包）

加入那三个POI包之后，再次运行项目，OK。

--------------20191213更新

NoClassDefFoundError:可能出现的原因2：类里面包含了main方法。导致类无法初始化成功。删除main方法即可

 

Java中的Apache POI库：Excel操作从未如此简单
java专栏
08-19 1453
Apache POI是一个用于处理Microsoft Office格式文件的开源Java库。POI的“POI”其实是“Poor Obfuscation Implementation”的缩写，但它真正的含义是“Point Of Interest”，因为这个项目最初是为了处理Office文件中的特定部分（如图表）而创建的。Apache POI可以处理多种文件格式，包括.xls（Excel 97-2003）和.xlsx（Excel 2007及以上版本）。🔍。
Eclipse中导入外部jar包 使用poi进行excel读写出现Exception in thread “main“ java.lang.NoClassDefFoundError
Ressac_的博客
12-17 1312
1.将需要的jar放入工程下面的lib 2.右击工程文件build path 3.add jars选择所需的包 使用apache的poi来实现excel读写时，需要导入jar包，以上是导入的一般过程，但是按这个步骤导入jar包后出现Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkboo的报错，检查了导入的包没有问题，后来这个Eclipse——添加库(Add
Caused by: java.lang.ClassNotFoundException: org.apache.commons.collections.Transformer异常
08-18
主要介绍了Caused by: java.lang.ClassNotFoundException: org.objectweb.asm.Type异常，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook错误解决方法
m0_64685289的博客
05-07 5934
java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook错误解决方法
java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook 错误来源
热门推荐
daydayupx的专栏
03-30 3万+
我的是没有把相关包放到lib当中，所以报错
2025-08-21 22:08:22.632 [main] ERROR org.springframework.boot.SpringApplication:818 - Application run failed java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook
08-22
在 Spring Boot 应用中，出现 `java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook` 错误通常意味着类路径中缺少 Apache POI 的某些必要依赖。Apache POI 是一个用于处理 Microsoft ...
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook at com.camunda7.demo.SwaggerToExcelExporter.main(SwaggerToExcelExporter.java:23) Caused by: java.lang.ClassNotFoundException: org.apache.poi.xssf.usermodel.XSSFWorkbook at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:581) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:522) ... 1 more 怎么解决
08-23
`java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFWorkbook` 错误表明 Java 虚拟机在运行时找不到 `XSSFWorkbook` 类的定义。这通常不是编译时问题，而是运行时类路径中缺少必要的 JAR 文件。在...
Caused by: java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/XSSFCellStyle 怎样解决
07-24
`java.lang.NoClassDefFoundError: org.apache.poi.xssf.usermodel.XSSFCellStyle` 通常表明项目中缺少 Apache POI 的相关依赖。在使用 Apache POI 进行 Excel 导出时，必须确保所有必要的依赖库都已正确引入，尤其...
Exception in thread "main" java.lang.NoClassDefFoundError: org/apache/poi/POIXMLDocumentPart
05-30
`java.lang.NoClassDefFoundError: org/apache/poi/POIXMLDocumentPart` 错误通常表明程序在运行时缺少必要的类文件，这可能是由于依赖项未正确引入或版本冲突引起的。以下是可能的解决方案[^1]： #### 1. 检查POM...
poi-xssfworkbook.jar
11-08
XSSFWorkbook.jar在poi-ooxml-3.10-FINAL-e20140208.jar的org.apache.poi.xssf.usermodel.XSSFWorkbook中
NoClassDefFoundError: jxl/WorkbookSettings
03-19
NULL 博文链接：https://liuzidong.iteye.com/blog/711509
java使用poi及jxl的一些问题， 解决：java.lang.NoClassDefFoundError: org/apache/poi/xssf/usermodel/HSSFWorkbook
weixin_43958308的博客
02-14 7288
我上网找原因，可能大家用的都是老版本的jdk不会遇见这种情况，网上说是jar包没导入，以至于我把所有的包导入后依然出现这个问题，我是用的是poi，那么我换了思路使用jxl会怎么样，依然会出现问题。，我就直接把所有的jar包全部导入到lib下，全选lib下的jar包右键BuildPath，OK导入成功，创建个测试类，按照网上的教程，网上的教程零零散散，大多数介绍的都是分散的，对于刚接触poi，应该先看见最简单的源码才对啊，这里推荐CSDN里搜索到视频教程里的源码：创建简单的Excel文件并向里面写入数据。
java.lang.ClassNotFoundException: org.apache.poi.xssf.usermodel.XSSFWorkbook错误
tomatoarmys的博客
03-20 1万+
使用hutool进行Excel文档导出的时候出现了问题 java.lang.ClassNotFoundException: org.apache.poi.xssf.usermodel.XSSFWorkbook 报错显示错误在 writer.write(list, true); 拍错过后最终发现是由于poi版本太低导致,要将poi版本升至5,0,0 <dependency> <groupId>org.apache.poi</groupId>
java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook
weixin_42903592的博客
04-10 1万+
1： 一开始我在项目中用poi技术导出数据，poi版本是3.8，后来导出数据量大的是时候，比较慢，占用内存，老板说换成easyexcel技术。但是我在没有删掉原来的poi依赖的时候，导入easyexcel技术就出现了版本冲突的问题。后来看到网友说把 poi的版本换成3.17就可以，亲身尝试确实可行。下面是我现在用的依赖。。其实也有一个最简单的方法就是把poi依赖删掉，就不会有问题。 <d...
java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook] with root cause
weixin_30515513的博客
05-05 3369
一、问题描述 　　使用POI上传excel，本地可正常运行，开发服务器上报错。 二、异常信息如下： 2019-05-05 17:00:22,349 ERROR [http-nio-8080-exec-7] [dispatcherServlet] [DirectJDKLog.java:182] - Servlet.service() for servlet [dispatcherServl...
上传并导入excle模版报java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook
PPX、小布的博客
06-08 1317
3.15，换成3.17后Apache POI用于Java中的excel读写操作Row.CREATE_NULL_AS_BLANK方法将不存在，将其修改为Row.MissingCellPolicy.CREATE_NULL_AS_BLANK即可。：在做excel导出，进行接口工具测试的时候，发现后台抛异常java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook。
java.lang.ClassNotFoundException: org.apache.poi.hssf.usermodel.HSSFWorkbook 错误
mobclix的博客
10-27 4445
导出excel时报错： java.lang.ClassNotFoundException:org.apache.poi.hssf.usermodel.HSSFWorkbook 经查是由于引入了重复的poi-jar包引起的。移除多余的jar包，问题解决。
java.lang.ClassCastException: org.apache.poi.hssf.usermodel.HSSFSheet cannot be cast to org.apache.poi.xssf.streaming.SXSSFSheet
最新发布
09-04
<think> 我们遇到的问题是在使用POI库时出现的类型转换异常：`org.apache.poi.hssf.usermodel.HSSFSheet`不能转换为`org.apache.poi.xssf.streaming.SXSSFSheet`。这通常是由于同时操作两种不同格式的Excel文件（HSSF用于.xls格式，XSSF/SXSSF用于.xlsx格式）而导致的。 ### 问题原因分析 1. **混合使用不同格式的API** HSSF是POI中处理Excel 97-2003(.xls)格式的类，而SXSSF是处理Excel 2007+ (.xlsx)格式的流式API。两者不能互相转换[^1]。 2. **代码中未区分工作簿类型** 在操作工作表时，可能没有检查工作簿的实际类型，而直接将HSSFSheet当作SXSSFSheet使用。 3. **依赖冲突或版本问题** 如果项目中存在多个POI版本，或者依赖了不兼容的POI组件，也可能导致此异常[^2]。 ### 解决方案 #### 方案1：统一工作簿类型（推荐） 在创建或获取工作簿时，明确区分.xls和.xlsx格式： ```java // 读取文件时根据扩展名判断 Workbook workbook; if (fileName.endsWith(".xls")) { workbook = new HSSFWorkbook(); } else if (fileName.endsWith(".xlsx")) { // 使用SXSSFWorkbook处理大文件 workbook = new SXSSFWorkbook(); } else { throw new IllegalArgumentException("不支持的文件格式"); } // 获取工作表时同样需要类型判断 Sheet sheet = workbook.getSheetAt(0); if (workbook instanceof HSSFWorkbook) { HSSFSheet hssfSheet = (HSSFSheet) sheet; // 操作HSSFSheet } else if (workbook instanceof SXSSFWorkbook) { SXSSFSheet sxssfSheet = (SXSSFSheet) sheet; // 操作SXSSFSheet } ``` #### 方案2：使用通用接口 POI提供了统一的接口（如`Sheet`），应尽量使用通用接口方法： ```java // 声明为通用Sheet类型 Sheet sheet = workbook.getSheetAt(0); // 通用方法（两种格式都支持） int lastRowNum = sheet.getLastRowNum(); Row row = sheet.getRow(0); // 避免直接强制转换为具体实现类 ``` #### 方案3：检查依赖冲突 在Maven中检查POI依赖： ```xml <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.5</version> <!-- 统一版本 --> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.5</version> <!-- 保持相同版本 --> </dependency> ``` 运行`mvn dependency:tree`检查版本冲突，确保所有POI组件版本一致。 ### 错误代码示例分析 假设出现以下错误代码： ```java SXSSFSheet sheet = (SXSSFSheet) workbook.getSheetAt(0); // 当workbook是HSSFWorkbook时会崩溃 ``` 应改为： ```java Sheet sheet = workbook.getSheetAt(0); // 使用通用接口 if (sheet instanceof SXSSFSheet) { // SXSSFSheet特有操作 } else if (sheet instanceof HSSFSheet) { // HSSFSheet特有操作 } ``` ### 兼容性处理最佳实践 | 操作类型 | 通用API | 特有API处理方式 | |----------------|--------------------------|------------------------------------------| | 创建工作簿 | `WorkbookFactory.create` | 根据文件扩展名选择实现类 | | 获取单元格值 | `Cell.getCellType()` | 使用`CellType`枚举而非旧版`int`常量 | | 设置单元格样式 | `Cell.setCellStyle()` | 样式对象需通过对应工作簿创建 | > 📌 **关键原则**：始终通过工作簿实例创建依赖对象（如样式、字体等），避免跨工作簿类型使用对象[^3]。 §§相关问题§§ 1. 如何通过POI识别Excel文件格式（.xls/.xlsx）？ 2. 为什么POI在处理Excel时会占用大量内存？ 3. POI中HSSF和XSSF的主要性能差异是什么？ 4. 如何解决POI版本冲突导致的NoSuchMethodError？ [^1]: POI官方文档明确指出HSSF和XSSF/SXSSF互不兼容 [^2]: 常见于同时使用EasyExcel和POI直接操作的情况 [^3]: 样式对象绑定到特定工作簿实例 </think> ### 解决`HSSFSheet`无法转换为`SXSSFSheet`的ClassCastException问题 #### 📌 问题根本原因 1. **格式混用冲突** `HSSFSheet`是处理`.xls`格式（Excel 97-2003）的API，而`SXSSFSheet`是处理`.xlsx`格式（Excel 2007+）的流式API。两者属于不同的实现体系，不能直接转换[^1]。 2. **代码未区分工作簿类型** 在操作工作表时，未检查工作簿的实际类型（HSSFWorkbook 或 SXSSFWorkbook），直接进行强制类型转换。 3. **依赖版本冲突** 项目中可能存在多个POI版本，低版本API在高版本环境中调用时会出现兼容性问题[^2]。 #### 🔧 解决方案 ##### 方案1：使用通用接口（推荐） ```java Workbook workbook = ... // 获取工作簿实例 // ✅ 安全方式：通过接口操作 Sheet sheet = workbook.getSheetAt(0); // 使用通用Sheet接口 // 避免直接强制转换 // ❌ SXSSFSheet sxSheet = (SXSSFSheet) workbook.getSheetAt(0); ``` ##### 方案2：类型检查后再转换 ```java if (workbook instanceof SXSSFWorkbook) { SXSSFSheet sxSheet = ((SXSSFWorkbook) workbook).getSheetAt(0); // 执行.xlsx操作 } else if (workbook instanceof HSSFWorkbook) { HSSFSheet hssfSheet = ((HSSFWorkbook) workbook).getSheetAt(0); // 执行.xls操作 } ``` ##### 方案3：统一工作簿创建方式 创建时明确指定格式： ```java // 创建.xlsx工作簿（使用SXSSF） Workbook workbook = new SXSSFWorkbook(); // 创建.xls工作簿（使用HSSF） Workbook workbook = new HSSFWorkbook(); ``` #### ⚠️ 依赖冲突处理 在`pom.xml`中统一POI版本： ```xml <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi</artifactId> <version>5.2.5</version> <!-- 统一版本号 --> </dependency> <dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.5</version> <!-- 必须相同 --> </dependency> ``` 执行依赖检查： ```bash mvn dependency:tree | grep poi ``` #### 💡 最佳实践 1. **文件扩展名检查** ```java public Workbook createWorkbook(String filePath) { if (filePath.endsWith(".xlsx")) { return new SXSSFWorkbook(); // 流式处理大文件 } else if (filePath.endsWith(".xls")) { return new HSSFWorkbook(); } throw new IllegalArgumentException("Unsupported file format"); } ``` 2. **使用工厂模式** ```java Workbook workbook = WorkbookFactory.create(new File("data.xlsx")); ``` 3. **避免跨类型操作** ```java // 错误示例：混合创建 Workbook wb = new HSSFWorkbook(); Sheet sheet = wb.createSheet("Data"); SXSSFSheet streamingSheet = (SXSSFSheet) sheet; // 抛出ClassCastException ``` #### 📊 技术对比 | 特性 | HSSF (.xls) | SXSSF (.xlsx) | |---------------------|-------------------|---------------------| | 最大行数 | 65,536 | 1,048,576 | | 内存占用 | 高 | 低（流式处理） | | 适用场景 | 小文件 | 大数据量导出 | | 实现类 | HSSFSheet | SXSSFSheet | > **关键提示**：POI中所有工作簿实现都实现`Workbook`接口，所有工作表实现`Sheet`接口。应优先使用接口方法避免类型转换[^3]。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值