Jenkins声明式流水线报错java.lang.NoSuchMethodError：找不到stages方法

错误原因 #

1. 脚本式流水线误用声明式语法
   你在generateStage函数返回的闭包里用了stages块，但这个闭包属于脚本式流水线范畴，脚本式流水线没有stages这个DSL方法，只有声明式流水线的顶层pipeline结构下才能使用stages。

2. 声明式stage非法嵌套stages
   主流水线里的stage('Set credentials')直接嵌套了stages块，这违反声明式规则：stages只能作为pipeline的直接子节点，单个stage内部不能放置stages，只能使用steps、agent这类合法元素。

声明式流水线支持多stage并行 #

完全可以实现，推荐使用声明式原生的parallel语法，比混合脚本式写法更规范易维护，以下是修正后的完整脚本：

def services = ["A", "B", "C"]

pipeline {
    agent { label 'dotnet-agent' }
    stages {
        stage('Set credentials') {
            steps {
                // 在这里添加设置凭证的逻辑，比如withCredentials
                echo "Credentials configured"
            }
        }
        stage('Parallel Service Jobs') {
            parallel {
                // 遍历服务列表生成并行stage
                for (service in services) {
                    stage("Service ${service}") {
                        agent { label 'dotnet-agent' }
                        environment {
                            PROJECT = "myProject.${service}"
                            ARTIFACT_NAME = "${GIT_COMMIT}-${service}.zip"
                        }
                        stages {
                            stage("Build ${service}") {
                                steps {
                                    include "automation/jenkins/${service}/buildAndArtifact"
                                }
                            }
                            stage("Test ${service}") {
                                steps {
                                    dir("src/${PROJECT}.Tests") {
                                        sh "dotnet test ${PROJECT}.Tests.csproj -c ${ASPNETCORE_ENVIRONMENT}"
                                    }
                                }
                            }
                            stage("Deploy ${service}") {
                                steps {
                                    include "automation/jenkins/${service}/deploy"
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

关键修正点 #

• 移除了原脚本中混合脚本式的parallelStagesMap和generateStage函数，改用声明式原生parallel块结合循环生成并行stage，语法更合规。
• 将stage('Set credentials')内的非法stages嵌套改为直接放置steps，符合声明式流水线结构要求。
• 每个并行的服务stage内部可以正常嵌套子stages（这是声明式流水线允许的合法结构）。
• 修正了字符串插值问题：原脚本中'Build-${service}'使用单引号导致变量无法解析，改为双引号"Build ${service}"才能正确替换变量。

备选混合脚本式写法（保留函数风格） #

如果一定要用函数生成stage，可以调整为声明式兼容的写法：

def services = ["A", "B", "C"]

def generateServiceStage(service) {
    return {
        stage("Service ${service}") {
            agent { label 'dotnet-agent' }
            environment {
                PROJECT = "myProject.${service}"
                ARTIFACT_NAME = "${GIT_COMMIT}-${service}.zip"
            }
            stages {
                stage("Build ${service}") {
                    steps {
                        include "automation/jenkins/${service}/buildAndArtifact"
                    }
                }
                stage("Test ${service}") {
                    steps {
                        dir("src/${PROJECT}.Tests") {
                            sh "dotnet test ${PROJECT}.Tests.csproj -c ${ASPNETCORE_ENVIRONMENT}"
                        }
                    }
                }
                stage("Deploy ${service}") {
                    steps {
                        include "automation/jenkins/${service}/deploy"
                    }
                }
            }
        }
    }
}

pipeline {
    agent { label 'dotnet-agent' }
    stages {
        stage('Set credentials') {
            steps {
                echo "Credentials configured"
            }
        }
        stage('Parallel Tasks') {
            steps {
                script {
                    parallel services.collectEntries {
                        ["Service ${it}": generateServiceStage(it)]
                    }
                }
            }
        }
    }
}

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