Jenkins构建报错：无法解析Workbook类，求排查方案

编译错误日志 #

org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed:
WorkflowScript: 198: unable to resolve class Workbook 
 @ line 198, column 42.
                        Workbook xssfWorkBook = new XSSFWorkbook(file) 
1 error

    at org.codehaus.groovy.control.ErrorCollector.failIfErrors(ErrorCollector.java:309)
    at org.codehaus.groovy.control.CompilationUnit.applyToSourceUnits(CompilationUnit.java:981)
    at org.codehaus.groovy.control.CompilationUnit.doPhaseOperation(CompilationUnit.java:626)
    at org.codehaus.groovy.control.CompilationUnit.compile(CompilationUnit.java:575)
    at groovy.lang.GroovyClassLoader.doParseClass(GroovyClassLoader.java:323)
    at groovy.lang.GroovyClassLoader.parseClass(GroovyClassLoader.java:293)
    at groovy.lang.GroovyShell.parseClass(GroovyShell.java:677)
    at groovy.lang.GroovyShell.parse(GroovyShell.java:689)
    at org.jenkinsci.plugins.workflow.cps.CpsGroovyShell.doParse(CpsGroovyShell.java:142)
    at org.jenkinsci.plugins.workflow.cps.CpsGroovyShell.reparse(CpsGroovyShell.java:127)
    at org.jenkinsci.plugins.workflow.cps.CpsFlowExecution.parseScript(CpsFlowExecution.java:561)
    at org.jenkinsci.plugins.workflow.cps.CpsFlowExecution.start(CpsFlowExecution.java:513)
    at org.jenkinsci.plugins.workflow.job.WorkflowRun.run(WorkflowRun.java:335)
    at hudson.model.ResourceController.execute(ResourceController.java:101)
    at hudson.model.Executor.run(Executor.java:442)
Finished: FAILURE

相关代码片段 #

import org.apache.poi.ss.usermodel.*
import org.apache.poi.hssf.usermodel.*
import org.apache.poi.xssf.usermodel.*
import org.apache.poi.ss.util.*

...

stage("Load Box") {
    script {
        dir('box') {
            def first_cell = []

            def actObj = new ActiveXObject('Excel.Application')
            def actWorkBooks = actObj.WorkBooks.Open("path")
            def sheet = actWorkBooks.Sheets('path')

            FileInputStream excelFile = new FileInputStream(new File("path"))
            Workbook xssfWorkBook = new XSSFWorkbook(excelFile)
            XSSFSheet workSheet = xssfWorkBook.getSheet('sheetPath')

            for (Row r : workSheet) {
                Cell c = r.getCell(1)
                if (c != null) {
                    if (c.getCellType() == Cell.CELL_TYPE_NUMERIC) {
                        first_cell.add(1)
                    }
                }
            }                           
        }
    }
}

用户疑问 #

我的声明方式是否存在问题？还有哪些资源可以帮助我解决这个问题？

问题分析与解决 #

1. 声明方式的潜在问题 #

代码里Workbook作为org.apache.poi.ss.usermodel.Workbook接口，用它接收XSSFWorkbook实例的语法本身没问题。编译报错找不到类的核心原因，是Jenkins运行环境未正确加载Apache POI的依赖包，而非声明语法错误。

另外注意：代码同时混用了ActiveX操作Excel和Apache POI两种方式，ActiveX仅在Windows环境生效，若Jenkins部署在Linux/macOS上，这部分代码后续会触发运行错误，建议统一用Apache POI实现逻辑。

2. 核心解决步骤 #

• 引入Apache POI依赖：
  在Pipeline脚本开头添加@Grab注解直接拉取依赖（版本可按需调整，确保poi与poi-ooxml版本一致）：

  @Grab('org.apache.poi:poi:4.1.2')
  @Grab('org.apache.poi:poi-ooxml:4.1.2')
  

  也可通过Jenkins全局工具配置，在服务器层面安装对应依赖包。
• 验证依赖加载状态：
  尝试用全类名声明变量，测试是否能编译通过：

  org.apache.poi.ss.usermodel.Workbook xssfWorkBook = new org.apache.poi.xssf.usermodel.XSSFWorkbook(excelFile)
  

  若此写法生效，可确认是依赖未正确加载导致的问题。

3. 可用参考资源 #

• Jenkins官方文档中关于Pipeline依赖管理的章节，重点掌握@Grab注解和全局依赖配置方法。
• Apache POI官方文档，里面有完整的Groovy/Java操作Excel的示例代码，可用于验证代码逻辑正确性。
• Jenkins社区论坛的历史问题，大量开发者分享过依赖缺失导致类找不到问题的具体配置方案。

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