Jenkins Active Choice参数获取GitHub分支遇进程未退出问题求助

问题根源 #

你的代码卡住的核心原因：

• 未在git ls-remote命令中传入GitHub Personal Access Token（PAT），导致请求需要认证但进程等待输入，无法退出
• 使用execute()后未处理进程的错误输出流，导致缓冲区堆积引发进程挂起

修复方案 #

以下是利用Jenkins凭据管理、正确处理进程流的脚本，可直接用于Active Choice参数：

步骤1：确认凭据ID #

确保你在Jenkins凭据中存储的PAT的凭据ID已记录（比如命名为github_pat）

步骤2：替换为以下脚本 #

// 从Jenkins凭据中获取GitHub PAT
def pat = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(
    com.cloudbees.plugins.credentials.common.StandardUsernameCredentials.class,
    Jenkins.instance,
    null,
    null
).find { it.id == 'github_pat' }.password.toString()

// 构造带认证的git ls-remote命令，替换为你的仓库地址
def repoUrl = "https://${pat}@github.com/你的用户名/first-project.git"
def process = ["git", "ls-remote", "--heads", repoUrl].execute()

// 处理进程的输入和错误流，避免卡住
def output = new StringBuilder()
def error = new StringBuilder()
process.consumeProcessOutput(output, error)
process.waitFor()

// 如果命令执行失败，抛出错误提示
if (process.exitValue() != 0) {
    throw new Exception("获取分支失败：${error.toString()}")
}

// 提取并返回分支名（只保留refs/heads下的分支，过滤掉tags）
return output.toString().readLines().collect { line ->
    line.split()[1].replace('refs/heads/', '')
}.unique().sort()

关键改进点 #

• 安全获取凭据：通过Jenkins凭据API读取PAT，避免硬编码敏感信息
• 指定--heads参数：只获取分支（如果需要tags可以换成--tags，或去掉参数同时获取）
• 处理进程流：使用consumeProcessOutput同时处理标准输出和错误输出，防止进程因缓冲区满而挂起
• 错误处理：检查进程退出码，执行失败时抛出明确错误

验证方法 #

在Jenkins脚本控制台中测试上述代码（替换凭据ID和仓库地址），确认能正常返回分支列表后，再配置到Active Choice参数中。

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