Jenkins Git Parameter插件useRepository动态配置仓库参数为空咨询

问题根因 #

Git Parameter插件的useRepository参数仅匹配在Jenkins流水线配置页「Pipeline script from SCM」板块预先登记的仓库地址，运行时通过checkout动态拉取的仓库不会被插件识别，因此分支/标签下拉列表为空是插件本身的设计限制，和checkout逻辑无关。

可行方案 #

方案一：原生Git命令拉取引用，构造动态选择参数（推荐） #

无需依赖Git Parameter插件，直接通过git ls-remote查询远程仓库的分支和标签列表，构造Jenkins原生选择参数即可实现需求，支持完全动态定义仓库列表，无需提前在SCM配置中预设仓库：

def app_components = [
    BACKEND        : ["NAME": "backend", "GIT": "ssh://git@xxx.local/_git/backend"],
    FRONTEND       : ["NAME": "frontend", "GIT": "ssh://git@xxx.local/_git/frontend"]
]
pipeline {
    agent any
 
    stages {
        stage('参数生成') {
            steps {
                script {
                    dynamicParameters = []
                    app_components.each { name, components ->
                        // 直接查询远程仓库的分支和标签，无需完整checkout仓库
                        def refs = sh(
                            script: "git ls-remote --heads --tags ${components.GIT} | awk '{print \$2}' | sed -e 's#refs/heads/##' -e 's#refs/tags/##' | sort -u",
                            returnStdout: true,
                            credentialsId: 'XXX' // 替换为你的Git访问凭证ID
                        ).trim().split('\n')
                        // 构造动态选择参数
                        dynamicParameters << choice(
                            name: "BRANCH_${name}",
                            choices: refs,
                            defaultValue: refs.contains('develop') ? 'develop' : refs[0],
                            description: "选择${components.NAME}的分支/标签"
                        )
                    }
                    
                    def userInput = input(
                        id: 'userInput', 
                        message: '请选择各组件的分支/标签：',
                        parameters: dynamicParameters
                    )
                    println(userInput);
                }
            }
        }
    }
}

该方案优势：

• 无额外插件依赖，使用Jenkins原生功能即可实现
• 不受预设SCM配置限制，完全通过代码动态定义仓库列表
• 运行时拉取最新的分支/标签列表，数据实时性高

方案二：使用Active Choices插件实现搜索筛选 #

如果需要保留原Git Parameter插件的快速搜索筛选功能，可以安装Active Choices插件，通过Groovy脚本动态拉取分支/标签列表，支持输入筛选：

1. 安装「Active Choices Plugin」
2. 修改参数构造逻辑为Active Choices参数即可实现筛选功能。

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