Jenkins Pipeline：如何用变量传参触发带参构建并解决类型错误

问题根源 #

• 当job_params为字符串形式时，Jenkins无法直接将其识别为List<ParameterValue>类型，触发类型转换异常
• 字符串形式的参数列表只是Groovy代码文本，未被解析执行，无法实例化正确的参数对象

最佳解决方案 #

通过Groovy的evaluate()方法将字符串形式的参数代码动态解析为实际参数列表，同时兼容已为列表的场景：

pipeline {
    stages {
        stage('Deployment') {
            steps {
                script {
                    // 处理参数：字符串则解析为列表，列表则直接使用
                    def parsedParams = job_params instanceof String ? evaluate(job_params) : job_params
                    build job: job_path, parameters: parsedParams
                }
            }
        }
    }
}

关键说明 #

• evaluate()会执行字符串中的Groovy代码，将"[string(name: 'app_one', value: '4.8.6'), ...]"这类文本转换为真正的List<StringParameterValue>对象
• 增加类型判断，避免对已为列表的参数重复解析
• 注意：若job_params来自不可信来源，evaluate()存在安全风险，需确保参数内容完全可控

安全替代方案（无动态代码执行） #

如果担心动态执行代码的风险，可以手动解析字符串参数（以字符串类型参数为例）：

pipeline {
    stages {
        stage('Deployment') {
            steps {
                script {
                    def parsedParams = []
                    if (job_params instanceof String) {
                        // 去除首尾方括号，分割单个参数
                        def paramStrs = job_params.replaceAll(/^\[|\]$/, '').split(/,\s*(?=string\()/)
                        paramStrs.each { paramStr ->
                            // 提取name和value值
                            def name = (paramStr =~ /name:\s*'([^']+)'/)[0][1]
                            def value = (paramStr =~ /value:\s*'([^']+)'/)[0][1]
                            parsedParams.add(string(name: name, value: value))
                        }
                    } else {
                        parsedParams = job_params
                    }
                    build job: job_path, parameters: parsedParams
                }
            }
        }
    }
}

该方法仅支持字符串类型参数，若需兼容布尔、选择等其他类型参数，需扩展对应的解析逻辑。

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