Jenkinsfile报错：未找到DSL方法'when'，需实现循环执行Stage

这个错误的根源很明确：你在Scripted Pipeline风格的stage里使用了Declarative Pipeline专属的when指令。Jenkins Pipeline分两种语法风格，两者的指令不能混用：

• Declarative Pipeline是结构化的，用pipeline {}包裹，when是它特有的条件判断指令，只能在Declarative的stage块中使用；
• 而你在script {}块里写的循环和嵌套stage属于Scripted Pipeline的范畴，这里的stage是Scripted风格的，不支持when指令。

下面给你两种简单的修复方案：

方案1：用Groovy的if语句替代when（最直接） #

既然在script块里，直接用普通的Groovy条件判断来实现分支逻辑就行，完全适配当前的代码结构：

pipeline { 
    agent any 
    tools {} 
    parameters {} 
    environment {} 
    stages { 
        stage('Execute') { 
            steps { 
                script { 
                    // 注意：如果hostnameMap是Map，建议用hostnameMap.values()遍历；如果是List，用size()方法
                    for (int i = 0; i < hostnameMap.size(); i++) { 
                        def hostname = hostnameMap[i] // 用def声明变量，避免作用域问题
                        echo "Executing ${hostname}" 
                        stage("Backup previous build ${hostname}") { 
                            backup(hostname, env.appHome) 
                        } 
                        stage("Deploy ${hostname}") { 
                            steps { 
                                script { 
                                    // 用Groovy的if替代Declarative的when
                                    if (env.BRANCH_NAME ==~ /(dev|master)/) {
                                        deploy(hostname , env.appHome, env.appName) 
                                    } else {
                                        echo "Skipping deployment for ${hostname}: branch ${env.BRANCH_NAME} is not dev or master"
                                    }
                                } 
                            } 
                        } 
                        // ...其他逻辑
                    } 
                } 
            } 
        } 
    } 
}

方案2：调整为纯Declarative风格的动态Stage #

如果你更倾向于保留Declarative的语法特性，可以把循环逻辑放在一个父stage的script块中，动态生成符合Declarative规范的子stage（不过本质上子stage还是Scripted风格，所以依然建议用if处理条件）：

pipeline { 
    agent any 
    tools {} 
    parameters {} 
    environment {} 
    stages { 
        // 用一个父stage包裹动态生成的子stage
        stage('Run All Tasks') {
            steps {
                script {
                    // 遍历hostnameMap，这里假设是List，如果是Map可以用hostnameMap.each { key, value -> ... }
                    hostnameMap.each { hostname ->
                        stage("Backup previous build ${hostname}") {
                            steps {
                                backup(hostname, env.appHome)
                            }
                        }
                        stage("Deploy ${hostname}") {
                            steps {
                                script {
                                    if (env.BRANCH_NAME ==~ /(dev|master)/) {
                                        deploy(hostname, env.appHome, env.appName)
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

额外注意事项 #

• 确保hostnameMap是可正确遍历的对象：如果是List，用size()获取长度；如果是Map，建议用each遍历键值对，避免索引访问的问题；
• 循环内的变量建议用def声明，避免Jenkins Pipeline的作用域陷阱；

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