Jenkins声明式流水线：并行分支失败后跳过对应后续步骤

你的问题核心在于：声明式流水线中阶段的条件判断（when）会在阶段初始化时绑定变量值，直接修改全局环境变量无法让后续阶段感知到分支内的状态变化。以下是针对多数据库版本并行构建测试场景的可行方案：

核心思路 #

每个并行分支维护独立的失败状态，通过catchError捕获分支内的失败并标记状态，后续阶段根据该状态判断是否执行，同时保证分支间状态互不干扰。

完整示例代码 #

pipeline {
    agent any
    stages {
        stage('Multi-DB Parallel Build & Test') {
            parallel {
                stage('MySQL 5.x') {
                    agent any
                    environment {
                        DB_TYPE = 'mysql5'
                        // 分支内独立的失败标记变量
                        BRANCH_FAILED = false
                    }
                    stages {
                        stage('Build') {
                            steps {
                                // 捕获构建失败，仅标记当前阶段失败，不终止整个分支/流水线
                                catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') {
                                    sh './build.sh ${DB_TYPE}'
                                }
                                // 更新分支失败状态
                                script {
                                    BRANCH_FAILED = currentBuild.currentResult == 'FAILURE'
                                }
                            }
                        }
                        stage('Unit Test') {
                            when {
                                expression { !BRANCH_FAILED }
                            }
                            steps {
                                sh './test.sh unit ${DB_TYPE}'
                            }
                        }
                        stage('Integration Test') {
                            when {
                                expression { !BRANCH_FAILED }
                            }
                            steps {
                                sh './test.sh integration ${DB_TYPE}'
                            }
                        }
                    }
                }
                stage('PostgreSQL 12.x') {
                    agent any
                    environment {
                        DB_TYPE = 'postgresql12'
                        BRANCH_FAILED = false
                    }
                    stages {
                        stage('Build') {
                            steps {
                                catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') {
                                    sh './build.sh ${DB_TYPE}'
                                }
                                script {
                                    BRANCH_FAILED = currentBuild.currentResult == 'FAILURE'
                                }
                            }
                        }
                        stage('Unit Test') {
                            when {
                                expression { !BRANCH_FAILED }
                            }
                            steps {
                                sh './test.sh unit ${DB_TYPE}'
                            }
                        }
                        stage('Integration Test') {
                            when {
                                expression { !BRANCH_FAILED }
                            }
                            steps {
                                sh './test.sh integration ${DB_TYPE}'
                            }
                        }
                    }
                }
            }
        }
    }
    post {
        always {
            echo '所有并行分支执行完成，汇总结果中...'
            // 可添加结果汇总、通知等操作
        }
        failure {
            echo '至少一个分支执行失败'
        }
    }
}

关键细节说明 #

1. 分支独立状态管理：每个并行分支通过environment块定义专属的BRANCH_FAILED变量，避免分支间状态干扰。
2. catchError的作用：
   • stageResult: 'FAILURE'：将当前构建阶段标记为失败，保留失败记录。
   • buildResult: 'SUCCESS'：临时维持整个流水线的成功状态，让分支内后续阶段有机会执行判断（若需整个流水线最终失败，可将此参数改为FAILURE）。
3. 动态更新状态：在Build阶段后通过script块更新BRANCH_FAILED，确保后续阶段能获取最新的失败状态。
4. 条件跳过后续步骤：测试阶段通过when { expression { !BRANCH_FAILED } }判断，仅当分支未失败时才执行。

为什么之前的方案失效？ #

声明式流水线中，when表达式的求值时机是阶段初始化时，而非阶段执行前。如果直接修改全局环境变量，后续阶段的条件判断仍会使用初始化时的旧值，导致无法正确跳过失败分支的后续步骤。而分支内的环境变量结合动态脚本更新，能确保状态在分支内实时生效。

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