如何在Jenkins声明式多流水线中配置响应式级联选择参数并解决报错

错误根因 #

你收到的编译错误是因为声明式Pipeline的parameters块不支持直接传入$class开头的Map格式参数定义：

org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed: WorkflowScript: 4: Build parameters cannot be defined as maps @ line 4, column 9. [$class: 'CascadeChoiceParameter', ^

你所用的CascadeChoiceParameter属于Active Choices插件提供的自定义参数类型，不能直接以裸Map形式放在parameters块中。

前置依赖 #

确保你的Jenkins已安装以下插件：

• Extended Choice Parameter 插件
• Active Choices 插件

正确实现代码 #

推荐使用properties块在Pipeline外层统一管理所有参数，该方式级联逻辑生效稳定：

// 全局参数定义，放在pipeline块外部
properties([
    parameters([
        // 一级选择参数：资源类型
        extendedChoice(
            defaultValue: 'none', 
            description: 'Select the resource you want to modify', 
            multiSelectDelimiter: ',', 
            name: 'Resources', 
            quoteValue: false, 
            saveJSONParameterToFile: false, 
            type: 'PT_SINGLE_SELECT', 
            value: 'Compute, LIVE', 
            visibleItemCount: 2
        ),
        // 二级级联参数：关联选择项
        [
            $class: 'CascadeChoiceParameter', 
            choiceType: 'PT_SINGLE_SELECT',
            description: 'Select a choice',
            filterLength: 1,
            filterable: true,
            name: 'choice1',
            referencedParameters: 'Resources',
            script: [
                $class: 'GroovyScript',
                fallbackScript: [
                    classpath: [], 
                    sandbox: true, 
                    script: 'return ["ERROR"]'
                ],
                script: [
                    classpath: [], 
                    sandbox: true, 
                    script: '''
                        if (Resources == 'Compute') { 
                            // 选中Compute时返回2个选项
                            return['aaa','bbb']
                        } else if (Resources == 'LIVE') {
                            // 选中LIVE时返回3个选项，可根据需求自定义返回数组长度
                            return['ccc', 'ddd', 'eee']
                        } else {
                            // 未选中有效值时返回空数组隐藏选项
                            return []
                        }
                    '''.stripIndent()
                ]
            ]
        ]
    ])
])

pipeline {
    agent any
    stages {
        stage('验证参数') {
            steps {
                echo "选中的资源类型：${params.Resources}"
                echo "选中的关联选项：${params.choice1}"
            }
        }
    }
}

注意事项 #

• 首次运行该Pipeline时，参数配置会被自动加载到Jenkins任务的设置中，第二次运行即可在启动页看到级联选择效果
• 如果脚本执行无返回值，可进入「Manage Jenkins → In-process Script Approval」页面批准对应Groovy脚本的执行权限
• 你可以根据一级参数的选中值，自定义二级参数返回数组的长度，实现1-3个关联选项的动态展示需求

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