加载JenkinsPipelineSpecification失败，缺失Jenkins类依赖的问题求助

我正在尝试用Spock框架编写一个小型Groovy测试文件来加载Jenkinsfile，目的是编写单元测试验证Jenkinsfile是否正常工作，同时确保Jenkinsfile的更新不会破坏现有功能。

我的测试代码如下： #

package tests.library

import com.homeaway.devtools.jenkins.testing.JenkinsPipelineSpecification

public class JenkinsfileWithPropertySpec extends JenkinsPipelineSpecification {

    protected Script Jenkinsfile

    def setup() {
        Jenkinsfile = loadPipelineScriptForTest("pipelineConfig/Jenkinsfile")
    }

    def "Jenkinsfile"() {
        when:
        Jenkinsfile.run()

        then:
        1 * getPipelineMock("node")("legacy", _)
        1 * getPipelineMock("echo")("hello world")
    }
}

运行Gradle测试时出现如下错误： #

$ ~/source/gradle/gradle-8.0.2/bin/gradle clean test

> Task :compileTestGroovy FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':compileTestGroovy'.
> Unable to load class com.homeaway.devtools.jenkins.testing.JenkinsPipelineSpecification due to missing dependency Ljenkins/model/Jenkins;

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 1s
2 actionable tasks: 2 executed

我的build.gradle配置： #

apply plugin:   'groovy'

repositories {
    mavenCentral()
}

dependencies {
    testImplementation 'junit:junit:4.13'
    testImplementation 'org.codehaus.groovy:groovy-all:2.4.14'
    testImplementation 'org.spockframework:spock-core:1.1-groovy-2.4'
    testImplementation 'com.lesfurets:jenkins-pipeline-unit:1.1'
    testImplementation 'cglib:cglib-nodep:3.2.2'
    testImplementation 'org.objenesis:objenesis:1.2'
    testImplementation 'org.assertj:assertj-core:3.7.0'
    testImplementation 'com.homeaway.devtools.jenkins:jenkins-spock:2.1.5'
}

sourceSets {
    test {
        groovy {
            srcDirs= ['pipelineTests/groovy']
        }
    }
}

有没有大佬能指点一下我哪里出错了？谢谢！

问题分析与解决方案： #

这个错误的核心原因是**jenkins-spock依赖的JenkinsPipelineSpecification类需要Jenkins核心库的支持，但你的build.gradle中没有引入Jenkins核心依赖**，导致编译时找不到jenkins.model.Jenkins类。

具体修复步骤：

1. 添加Jenkins核心依赖
   在dependencies块中加入Jenkins核心及相关插件的测试依赖，建议选择和你实际Jenkins环境版本匹配的版本（示例中使用的是Jenkins 2.387.3版本）：

testImplementation 'org.jenkins-ci.main:jenkins-core:2.387.3'
// 若后续还出现其他Jenkins类缺失，可添加工作流相关依赖
testImplementation 'org.jenkins-ci.plugins:workflow-job:1.41'

2. 避免依赖冲突（可选）
   你同时引入了jenkins-pipeline-unit和jenkins-spock两个Jenkinsfile测试库，二者功能存在重叠，可能引发依赖冲突。建议只保留其中一个，比如如果使用jenkins-spock，可以移除com.lesfurets:jenkins-pipeline-unit:1.1依赖。

修改后的dependencies示例：

dependencies {
    testImplementation 'junit:junit:4.13'
    testImplementation 'org.codehaus.groovy:groovy-all:2.4.14'
    testImplementation 'org.spockframework:spock-core:1.1-groovy-2.4'
    testImplementation 'cglib:cglib-nodep:3.2.2'
    testImplementation 'org.objenesis:objenesis:1.2'
    testImplementation 'org.assertj:assertj-core:3.7.0'
    testImplementation 'com.homeaway.devtools.jenkins:jenkins-spock:2.1.5'
    // 添加Jenkins核心依赖
    testImplementation 'org.jenkins-ci.main:jenkins-core:2.387.3'
    testImplementation 'org.jenkins-ci.plugins:workflow-job:1.41'
}

修改完成后重新运行gradle clean test，应该就能解决编译错误了。

备注：内容来源于stack exchange，提问作者Niranjan M.R