如何在Jenkins Pipeline中并行化Javadoc与集成测试相关阶段？

你的Pipeline未按预期并行，核心原因在于并行分支内嵌套的stages结合when条件后，当仅匹配单一OS环境时，分支内逻辑被拆分为串行子stage，导致并行效果不明显；同时集成测试分支的报告发布阶段未加环境判断，可能在无测试结果时触发报错。

修正后的Pipeline代码（简化版） #

stage('并行执行Javadoc与集成测试') {
    parallel {
        stage('生成并发布Javadoc') {
            steps {
                script {
                    if (env.OS == 'UNIX') {
                        sh './gradlew javadoc'
                        javadoc javadocDir: 'build/docs/javadoc', keepAll: true
                    } else if (env.OS == 'BAT') {
                        bat 'gradlew.bat javadoc'
                        javadoc javadocDir: 'build/docs/javadoc', keepAll: true
                    }
                }
            }
        }

        stage('执行并发布集成测试') {
            steps {
                script {
                    // 按环境执行集成测试
                    if (env.OS == 'UNIX') {
                        sh './gradlew integrationTest'
                    } else if (env.OS == 'BAT') {
                        bat 'gradlew.bat integrationTest'
                    }
                    // 统一发布测试结果与报告
                    junit '**/build/test-results/integrationTest/*.xml'
                    publishHTML(target: [
                        allowMissing         : false,
                        alwaysLinkToLastBuild: false,
                        keepAll              : true,
                        reportDir            : 'build/reports/tests/integrationTest',
                        reportFiles          : 'index.html',
                        reportName           : '集成测试报告'
                    ])
                }
            }
        }
    }
}

关键修改点 #

• 移除并行分支内的嵌套stages，改用script块+条件判断处理跨OS逻辑，确保每个并行分支是独立完整的执行单元，避免子stage串行导致的并行感知问题。
• 将集成测试的执行与报告发布合并到同一分支，保证测试完成后立即发布报告，逻辑连贯且避免无测试结果时的报错风险。

保留子stage可视化的版本 #

如果需要在Jenkins界面保留各OS步骤的可视化，可调整为如下结构：

stage('并行执行Javadoc与集成测试') {
    parallel {
        stage('Javadoc分支') {
            stages {
                stage('Linux生成Javadoc') {
                    when { expression { env.OS == 'UNIX' } }
                    steps {
                        sh './gradlew javadoc'
                        javadoc javadocDir: 'build/docs/javadoc', keepAll: true
                    }
                }
                stage('Windows生成Javadoc') {
                    when { expression { env.OS == 'BAT' } }
                    steps {
                        bat 'gradlew.bat javadoc'
                        javadoc javadocDir: 'build/docs/javadoc', keepAll: true
                    }
                }
            }
        }

        stage('集成测试分支') {
            stages {
                stage('Linux执行集成测试') {
                    when { expression { env.OS == 'UNIX' } }
                    steps {
                        sh './gradlew integrationTest'
                        junit '**/build/test-results/integrationTest/*.xml'
                    }
                }
                stage('Windows执行集成测试') {
                    when { expression { env.OS == 'BAT' } }
                    steps {
                        bat 'gradlew.bat integrationTest'
                        junit '**/build/test-results/integrationTest/*.xml'
                    }
                }
                stage('发布集成测试报告') {
                    when { anyOf {
                        expression { env.OS == 'UNIX' }
                        expression { env.OS == 'BAT' }
                    } }
                    steps {
                        publishHTML(target: [
                            allowMissing         : false,
                            alwaysLinkToLastBuild: false,
                            keepAll              : true,
                            reportDir            : 'build/reports/tests/integrationTest',
                            reportFiles          : 'index.html',
                            reportName           : '集成测试报告'
                        ])
                    }
                }
            }
        }
    }
}

该版本保留子stage的可视化，同时给报告发布阶段添加环境判断，确保仅在对应OS环境下执行。

内容的提问来源于stack exchange，提问作者P.Brito