如何在JobDSL脚本中访问指定的Jenkins任务参数？

我之前也踩过这个坑！你遇到的错误本质是JobDSL里的参数并非直接以属性形式挂载在对象上，直接用.REPOSITORY_NAME访问自然会报错。下面给你两种最常见场景的正确写法：

场景1：从已有Jenkins任务中获取特定参数的值 #

如果你是要读取一个已经存在的任务里的REPOSITORY_NAME参数，需要先拿到任务的参数定义集合，再通过名称匹配找到目标参数：

// 替换成你的目标任务全名（含文件夹路径）
def targetJob = Jenkins.instance.getItemByFullName('your/project/job-name')

// 获取任务的参数定义集合，找到名称匹配的参数
def repoParam = targetJob.getProperty(ParametersDefinitionProperty)?.parameterDefinitions?.find {
    it.name == 'REPOSITORY_NAME'
}

if (repoParam) {
    // 根据参数类型处理值：比如字符串参数取defaultValue
    def repoName = repoParam.defaultValue
    println "成功获取参数REPOSITORY_NAME的值：${repoName}"
    
    // 如果是其他类型参数，比如选择参数，可能要取options或者defaultValue
    // def repoOptions = repoParam.choices
} else {
    println "未找到名称为REPOSITORY_NAME的参数"
}

场景2：在创建新任务时引用/使用该参数 #

如果是在DSL脚本里创建新任务，同时要在任务的构建步骤中使用REPOSITORY_NAME参数，直接在对应步骤里用变量引用即可（Jenkins会自动解析）：

job('new-build-job') {
    parameters {
        stringParam('REPOSITORY_NAME', 'default-repo', '代码仓库名称')
    }
    steps {
        shell('git clone https://your-git-server/${REPOSITORY_NAME}.git')
        // 或者在DSL逻辑中动态使用参数值（比如根据参数选择分支）
        scm {
            git {
                branch('*/main')
                remote {
                    url("https://your-git-server/${REPOSITORY_NAME}.git")
                }
            }
        }
    }
}

关键注意点 #

• 不要直接尝试用params.REPOSITORY_NAME这种方式访问，JobDSL的上下文里没有这个直接可用的params对象（流水线里才有）。
• 注意空值判断：getProperty(ParametersDefinitionProperty)可能返回null（如果任务没有参数），所以要用安全调用运算符?.避免空指针。

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