Jenkins动态选择参数Groovy脚本迁移至新环境后失效求助

问题背景 #

之前在Ubuntu 18.04、Jenkins 2.33环境下，我通过以下Groovy脚本调用/usr/local/bin目录下的branches.sh脚本，获取指定GitLab仓库的分支列表，将其作为构建时的动态选择参数选项：

tags = []
text = "branches.sh https://gitlab.com/xyz/${services}.git".execute().text
text.eachLine { tags.push(it) }
return tags

但迁移到Ubuntu 22.04、Java 11、Jenkins 2.36环境后，该脚本完全失效，branches.sh仍位于/usr/local/bin目录，需要恢复分支列表的动态参数功能。

可能的失效原因 #

• Jenkins升级后，运行用户的环境变量PATH未包含/usr/local/bin，导致找不到branches.sh脚本
• Java 11对Process类的执行逻辑有调整，原脚本未处理错误输出，异常被静默吞掉
• Jenkins新的安全策略限制了Groovy脚本执行外部进程的权限
• branches.sh脚本本身在新环境下执行失败（如git版本不兼容、GitLab访问权限变更）

修复方案 #

1. 改用脚本绝对路径并处理错误输出 #

直接指定branches.sh的绝对路径，同时捕获错误输出，方便排查问题：

def branchList = []
// 调用脚本时使用绝对路径
def process = "/usr/local/bin/branches.sh https://gitlab.com/xyz/${services}.git".execute()
// 等待脚本执行完成
process.waitFor()

// 先检查错误输出
def errorMsg = process.err.text
if (errorMsg?.trim()) {
    throw new RuntimeException("执行分支脚本失败: ${errorMsg}")
}

// 读取正常输出并过滤空行
def output = process.in.text
output.eachLine { line ->
    def trimmedLine = line.trim()
    if (trimmedLine) {
        branchList.add(trimmedLine)
    }
}

return branchList

2. 确保Jenkins运行用户能访问脚本 #

切换到Jenkins运行用户（通常是jenkins），手动执行以下命令验证脚本可用性：

su - jenkins
/usr/local/bin/branches.sh https://gitlab.com/xyz/你的服务名.git

如果执行失败，检查：

• 脚本是否有可执行权限：chmod +x /usr/local/bin/branches.sh
• 脚本依赖的git命令是否存在：which git
• GitLab仓库的访问权限是否正常（比如SSH密钥、访问令牌是否配置正确）

3. 调整Jenkins环境变量或安全策略 #

• 环境变量配置：进入Jenkins管理页面→系统配置→全局属性，添加环境变量PATH，值设为/usr/local/bin:$PATH
• 脚本安全授权：进入Jenkins管理页面→全局安全配置→脚本安全，在"脚本批准"中允许Groovy调用java.lang.Process.execute()相关方法

4. 适配Java 11的Process处理逻辑 #

Java 11中，Process的输入流和错误流需要单独处理，避免因流阻塞导致脚本挂起。上述修复方案的代码已经通过分开读取in和err流，并调用waitFor()等待执行完成，解决了这个问题。

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