JavaFX项目导入Excel时出现NoSuchMethodError问题求助

这个错误java.lang.NoSuchMethodError: org.apache.poi.ss.usermodel.Workbook.sheetIterator()Ljava/util/Iterator;本质是编译时和运行时的POI版本不匹配，或者项目中混入了多个版本的POI jar包导致类加载冲突。结合你使用的POI 3.17版本，给你几个针对性的解决方案：

1. 彻底清理并统一POI依赖版本 #

• 先检查项目的lib目录和IDE的依赖库（比如IDEA的Libraries/Eclipse的Build Path），把所有非3.17版本的POI相关jar包全部删除，确保只保留你列出的POI 3.17系列jar：POI-3.17.jar、poi-examples-3.17.jar、poi-excelant-3.17.jar、poi-ooxml-3.17.jar、poi-ooxml-schemas-3.17.jar、poi-scratchpad-3.17.jar
• 特别注意：有时候其他第三方依赖会间接引入旧版本POI，一定要排查干净，避免版本冲突

2. 补充POI 3.17必需的基础依赖jar包 #

POI 3.17运行还依赖几个核心基础jar，你可能没引入，这也可能引发类加载异常：

• xmlbeans-2.6.0.jar
• commons-codec-1.10.jar
• commons-collections4-4.1.jar
• commons-logging-1.2.jar
  把这些jar加入项目依赖，确保版本和POI 3.17完全兼容

3. 检查运行时ClassPath加载顺序 #

• 在IDE的运行配置里，查看ClassPath列表，确保POI 3.17的jar包排在最前面，避免旧版本jar被优先加载
• 如果是打包成可执行jar运行，检查打包工具（比如Maven/Gradle或手动打包）的依赖打包规则，确保只打包3.17版本的POI相关jar

4. 临时兼容方案：替换sheetIterator()为旧API #

如果暂时无法解决版本冲突，可以把调用sheetIterator()的代码替换成POI旧版本支持的遍历方式，直接绕过版本问题：

// 原来报错的代码
Iterator<Sheet> sheetIterator = workbook.sheetIterator();
while (sheetIterator.hasNext()) {
    Sheet sheet = sheetIterator.next();
    // 你的业务逻辑
}

// 替换为兼容旧版本的代码
for (int i = 0; i < workbook.getNumberOfSheets(); i++) {
    Sheet sheet = workbook.getSheetAt(i);
    // 你的业务逻辑
}

内容的提问来源于stack exchange，提问作者Tata Nyerere