如何使用JenkinsPipelineUnit测试共享库中的声明式流水线代码

你遇到的问题核心原因是：独立Jenkinsfile的pipeline是顶层可执行逻辑，调用runScript加载时会直接执行；而共享库vars目录下的脚本将pipeline封装在call方法中，仅加载脚本不会主动触发该方法执行，因此没有任何输出。

解决方案 #

修改测试用例，加载脚本后手动调用call方法传入配置参数即可，修改后的测试代码如下：

package vars

import org.junit.Before
import org.junit.Test
import com.lesfurets.jenkins.unit.declarative.*

class ExampleDeclarativePipelineTest extends DeclarativePipelineTest {
  // 配置测试环境
  @Override
  @Before
  public void setUp() throws Exception {
    super.setUp()
    // 可根据实际情况调整脚本根目录配置，确保runScript能正确定位vars目录文件
    // helper.scriptRoots = new File("你的项目根路径/src/test/resources").toPath()
  }

  @Test
  public void should_execute_without_errors() throws Exception {
      // 第一步：加载共享库脚本对象
      def script = runScript("vars/exampleDeclarativePipeline.groovy")
      // 第二步：主动调用call方法，无参数传空Map即可，有参数按实际需求传入
      script.call([:])
      // 执行断言与调用栈打印
      assertJobStatusSuccess()
      printCallStack()
  }
}

额外注意事项 #

• 若你的call方法定义了必填入参，调用时需要传入完整参数，否则会抛出参数缺失异常
• 框架默认会mock掉docker agent的执行逻辑，不会真实拉取镜像运行容器，符合单元测试的隔离要求
• 若你的流水线中用到了其他共享库提供的自定义方法，需要在setUp阶段提前注册对应的mock逻辑，避免方法找不到的错误

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