Jenkinsfile多分支检出报错：无法找到构建版本

核心现象确认 #

• 同一仓库连续三次检出，前两次成功，第三次无论调换哪个分支都会失败
• GUI流水线执行相同操作无异常，仅通过Jenkinsfile脚本执行时触发错误

具体排查步骤 #

1. 清理Git缓存与强制干净检出 #

第三次检出前，避免前两次操作留下的缓存干扰：

• 在每个checkout块中添加CleanCheckout扩展，确保每次检出都是全新状态：

checkout([$class: 'GitSCM',
    branches: [[name: "${predictor_selected_branch_or_tag}"]],
    userRemoteConfigs: [[credentialsId: 'omer_creds', url: "https://Omeresh@bitbucket.org/AmichaiHerman/python-ml.git"]],
    doGenerateSubmoduleConfigurations: false,
    extensions: [[$class: 'CleanCheckout']]
])

• 或者在第三次检出前执行目录清理：

dir("temp_predictor") {
    deleteDir()
    checkout([...])
}

2. 验证变量传递的准确性 #

• 在第三次检出前打印变量值，确认分支/标签名称格式正确（无多余空格、特殊字符）：

echo "待检出分支/标签：${predictor_selected_branch_or_tag}"

• 排查前两个dir块中的操作是否意外覆盖了predictor_selected_branch_or_tag变量

3. 检查Jenkins节点的资源与权限 #

• 确认执行节点磁盘空间充足，避免因磁盘满导致第三次检出无法写入文件
• 升级节点上的Git版本到最新稳定版，部分旧版本Git处理重复仓库检出可能存在bug
• 重启Jenkins节点清除凭证缓存，虽然前两次成功，但可能存在凭证临时失效的情况

4. 调整检出逻辑避免重复仓库冲突 #

• 改为一次性拉取所有需要的分支，再复制到对应目录：

checkout([$class: 'GitSCM',
    branches: [
        [name: "${pn_selected_branch_or_tag}"],
        [name: "${pn2_selected_branch_or_tag}"],
        [name: "${predictor_selected_branch_or_tag}"]
    ],
    userRemoteConfigs: [[credentialsId: 'omer_creds', url: "https://Omeresh@bitbucket.org/AmichaiHerman/python-ml.git"]]
])
sh 'cp -r . temp_pn && cp -r . temp_pn2 && cp -r . temp_predictor'

• 每次检出后断开与远程仓库的关联：

dir("temp_predictor") {
    checkout([...])
    sh 'git remote remove origin'
}

5. 启用详细日志定位问题 #

在Jenkins启动参数中添加-Dorg.jenkinsci.plugins.gitclient.GitClient.level=FINEST，查看第三次检出时Git的交互细节，确定是拉取失败、分支不存在还是权限类问题

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