Jenkins Extended Choice参数如何从Slave节点外部JSON文件读取默认值

根本原因 #

问题来自两个核心限制：

• Extended Choice参数的Groovy脚本运行在Jenkins Master节点、任务触发前执行，此时还未为任务分配Slave节点，不可能直接读取Slave节点上的文件；同时运行环境没有注入Pipeline步骤，你用的readJSON是Jenkins Pipeline专属函数，普通Groovy环境无法识别。
• 你指定的/etc/configs/version.json路径是Slave节点的路径，Master节点上不存在对应路径或文件内容不符合预期。

可行解决方案 #

方案1：文件存放在Jenkins Master节点（推荐） #

如果可以将版本JSON文件同步到Jenkins Master的相同路径下，直接使用原生Groovy语法读写解析文件即可，代码示例：

import groovy.json.JsonSlurper
// 路径为Jenkins Master节点上的绝对路径
def versionFile = new File("/etc/configs/version.json")
// 增加异常兼容逻辑避免脚本运行失败
if (!versionFile.exists() || !versionFile.canRead()) {
    // 兜底默认值，可根据业务调整
    return "default_version"
}
try {
    def jsonContent = new JsonSlurper().parse(versionFile)
    return jsonContent.VERSION
} catch(Exception e) {
    // 错误日志会输出到Jenkins Master的运行日志中，可用于排查问题
    println "解析version.json失败：${e.getMessage()}"
    return "default_version"
}

操作注意：需要给Jenkins Master的运行用户授予该文件的读权限。 #

方案2：必须读取Slave节点上的文件 #

由于参数配置阶段无法获取到Slave节点信息，需要调整实现逻辑，把参数赋值逻辑放到Pipeline执行阶段：

1. 新增普通字符串类型的VERSION参数，默认值留空或设置兜底值
2. 在Pipeline的首个执行阶段完成参数赋值，示例代码：

pipeline {
    agent { label "你的目标Slave节点标签" }
    stages {
        stage("参数初始化") {
            steps {
                script {
                    // 仅当用户未手动输入版本号时自动读取文件
                    if (params.VERSION.trim() == "") {
                        // 此时逻辑运行在已分配的Slave节点上，可直接使用Pipeline readJSON步骤
                        def versionConfig = readJSON file: "/etc/configs/version.json"
                        params.VERSION = versionConfig.VERSION
                        echo "自动读取版本号为：${params.VERSION}"
                    }
                }
            }
        }
        // 后续所有阶段可正常使用params.VERSION变量
    }
}

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