如何在Jenkins中异步运行Freestyle下游任务并检查构建状态

问题描述 #

当前通过wait: false和propagate: false参数异步启动多个Freestyle下游任务的Pipeline代码如下：

node {
    stage('Testing') {
        build job: 'Test1', parameters: [string(name: 'Name', value: 'Foo1')], propagate: false, wait: false
        build job: 'Test2', parameters: [string(name: 'Name', value: 'Bar1')], propagate: false, wait: false
        build job: 'Test3', parameters: [string(name: 'Name', value: 'Baz1')], propagate: false, wait: false
        build job: 'Test4', parameters: [string(name: 'Name', value: 'Foo2')], propagate: false, wait: false
        build job: 'Test5', parameters: [string(name: 'Name', value: 'Bar2')], propagate: false, wait: false
        build job: 'Test6', parameters: [string(name: 'Name', value: 'Baz2')], propagate: false, wait: false
    }
}

需求为任一下游任务失败时，将当前阶段标记为不稳定状态，但直接尝试获取异步任务结果时触发NullPointerException: Cannot get property 'result' on null object错误——原因是wait: false模式下，build方法返回的对象尚未包含运行结果（任务仍在执行中）。

错误尝试代码示例：

def downstream = build job: TEST1, wait: false, propagate: false, parameters: parameters
if (downstream.getResult() != 'SUCCESS') {
    unstable(message: "Downstream job result is ${downstream.result}")
}

解决方案 #

要实现异步启动下游任务后，等待所有任务完成并检查结果，可按以下方式修改Pipeline：

核心思路 #

1. 批量异步启动所有下游任务，收集每个任务的构建对象
2. 遍历所有构建对象，显式等待任务完成后校验执行结果
3. 若存在失败任务，标记当前Pipeline阶段为不稳定

完整实现代码 #

node {
    stage('Testing') {
        // 存储所有下游任务的构建实例
        def downstreamBuilds = []
        
        // 异步启动所有下游任务，将构建实例存入列表
        downstreamBuilds << build(job: 'Test1', parameters: [string(name: 'Name', value: 'Foo1')], propagate: false, wait: false)
        downstreamBuilds << build(job: 'Test2', parameters: [string(name: 'Name', value: 'Bar1')], propagate: false, wait: false)
        downstreamBuilds << build(job: 'Test3', parameters: [string(name: 'Name', value: 'Baz1')], propagate: false, wait: false)
        downstreamBuilds << build(job: 'Test4', parameters: [string(name: 'Name', value: 'Foo2')], propagate: false, wait: false)
        downstreamBuilds << build(job: 'Test5', parameters: [string(name: 'Name', value: 'Bar2')], propagate: false, wait: false)
        downstreamBuilds << build(job: 'Test6', parameters: [string(name: 'Name', value: 'Baz2')], propagate: false, wait: false)
        
        // 检查所有下游任务的执行结果
        def hasFailedJob = false
        downstreamBuilds.each { build ->
            // 等待当前下游任务执行完成
            build.waitForCompletion()
            // 判断任务是否失败
            if (build.result == 'FAILURE') {
                hasFailedJob = true
                echo "下游任务 [${build.projectName}] 执行失败，构建编号：${build.number}"
            }
        }
        
        // 若存在失败任务，标记当前阶段为不稳定
        if (hasFailedJob) {
            unstable(message: '部分下游任务执行失败，当前阶段标记为不稳定')
        }
    }
}

关键细节说明 #

• wait: false：保持异步启动特性，不阻塞Pipeline主线程，先完成所有任务的启动操作
• build.waitForCompletion()：显式等待单个下游任务执行结束，确保能安全获取result属性，避免空指针异常
• propagate: false：即使下游任务失败，也不会中断当前Pipeline的执行，保证所有任务都能完成检查
• unstable：仅标记当前Pipeline为不稳定状态，而非直接失败，符合需求中"阶段标记为不稳定"的要求

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