Jenkins并行生成与启动阶段报错问题排查

错误原因 #

Jenkins流水线的parallel方法要求传入键为阶段名称、值为执行逻辑闭包的Map，但你当前的stages_to_run闭包只是循环创建了顺序执行的stage节点，并没有返回符合parallel要求的结构。当调用parallel stages_to_run()时，实际传入的是each方法的返回值（即原map对象），而非parallel期望的命名参数Map，因此触发IllegalArgumentException。

修正方案 #

需要将逻辑调整为生成parallel所需的Map结构，每个entry对应一个并行执行的单元。以下是两种可行写法：

写法1：封装为方法返回并行Map #

def map = [
        Gosha  : 45,
        Gera : 15,
        Serega  : 33
]

def getParallelStages() {
    def stages = [:]
    map.each { key, value ->
        // 给Map添加键值对：键是阶段名，值是包含执行逻辑的闭包
        stages["phase_${key}"] = {
            echo "name: 'Name', value: ${key}"
            echo "name: 'Age', value: ${value}"
        }
    }
    return stages
}

pipeline {
    agent any
    stages {
        stage('loop') {
            steps {
                script {
                    parallel getParallelStages() // 传入符合要求的Map
                }
            }
        }
    }
}

写法2：直接在parallel中构建Map（更简洁） #

def map = [
        Gosha  : 45,
        Gera : 15,
        Serega  : 33
]

pipeline {
    agent any
    stages {
        stage('loop') {
            steps {
                script {
                    // 使用collectEntries直接转换原map为parallel所需结构
                    parallel map.collectEntries { key, value ->
                        ["phase_${key}": {
                            echo "name: 'Name', value: ${key}"
                            echo "name: 'Age', value: ${value}"
                        }]
                    }
                }
            }
        }
    }
}

关键要点 #

• parallel的核心要求是接收Map<String, Closure>，每个闭包会作为独立的并行任务执行
• 无需在并行闭包内嵌套stage，因为parallel的每个entry本身就对应一个并行执行的阶段单元
• Groovy的collectEntries方法可以高效地将原数据Map转换为符合Jenkins要求的并行任务Map

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