Jenkins-spock共享库方法mock跨环境运行失败问题咨询

问题根因 #

1. 你在vars/deleteFile.groovy中定义的是自定义共享库函数，不属于Jenkins内置流水线步骤，explicitlyMockPipelineStep是专门用于mock插件提供的内置步骤的方法，不能用于自定义vars的mock，这是核心用法错误。
2. 跨环境表现不一致的原因是：你本地测试使用Java 14运行，而你引入的jenkins-spock 2.0.0版本兼容范围最高到Java 11，字节码兼容问题导致本地环境框架自动扫描绑定自定义vars的逻辑失效，才会出现本地找不到mock、CI环境手动mock后类型冲突的情况。

解决方案 #

1. 修正单元测试mock逻辑

不要调用explicitlyMockPipelineStep，直接给加载的测试脚本绑定mock闭包即可，修改后测试代码如下：

class TotoSpec extends JenkinsPipelineSpecification {

    def toto = null

    def setup() {
        toto = loadPipelineScriptForTest('vars/toto.groovy')
        // 给测试脚本绑定自定义deleteFile的mock闭包
        toto.getBinding().setVariable('deleteFile', Mock(Closure))
        // 其余原有setup逻辑保持不变
        ...
    }

    def '[toto] test env file'() {
        when:
        toto envFile: 'env.list'

        then:
        ...
        // 验证mock闭包的调用次数和参数
        1 * toto.getBinding().getVariable('deleteFile').call('env.list')
    }
}

2. 统一测试运行环境

本地测试也切换为Java 11运行，和CI slave环境保持一致，避免因JDK版本差异导致的框架逻辑异常。如果需要保留本地Java 14作为全局JDK，可以在Maven的settings.xml或者项目的.mvn/jvm.config中指定测试运行时使用Java 11。

可选检查项

确认项目目录结构符合jenkins-spock的默认规则：自定义vars放在src/main/vars目录下，测试代码放在src/test/groovy目录下，框架会自动扫描自定义vars，不需要额外配置。

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