Jenkins作业中git show-branch返回结果与本地不一致问题排查

Jenkins GitSCM插件的默认检出逻辑，和本地手动执行git clone的行为存在差异：

• 本地手动克隆仓库时，Git会默认拉取远程所有分支的引用，生成本地远程跟踪分支记录，git show-branch能识别到这些存在的分支引用，就会同时展示当前分支和父分支的关联提交历史。
• Jenkins默认构建时，只会拉取本次触发构建的单个分支的提交对象，不会抓取其他分支的ref记录，本地工作区的仓库里根本没有其他分支的引用信息，git show-branch自然只能输出当前单分支的提交。
  你配置里写的branches: [[name: '*/*']]只是告诉插件哪些分支可以触发构建，不会改变默认单分支fetch的逻辑，这是最容易踩的配置误区。

直接在Jenkins构建步骤里加两条命令验证即可：

• 执行git branch -a，你会看到输出里只有当前检出的分支，看不到其他本地分支、远程跟踪分支的记录，和本地仓库的输出对比差异非常明显。
• 执行git config remote.origin.fetch，会看到默认配置是只拉取当前构建分支的refspec，而非全部分支。

修改checkout步骤的配置，显式指定拉取全部分支的引用即可，参考配置如下：

checkout ([
    $class: 'GitSCM',
    branches: [[name: '*/*']],
    doGenerateSubmoduleConfigurations: false,
    extensions: [
        [$class: 'CloneOption', shallow: false, noTags: false],
        [$class: 'PruneStaleBranch']
    ],
    submoduleCfg: [],
    userRemoteConfigs: [[
        credentialsId: 'id123',
        url: 'https://url123.com/repo.git',
        refspec: '+refs/heads/*:refs/remotes/origin/*'
    ]]
])

配置核心是两点：

• 在userRemoteConfigs里显式指定refspec为+refs/heads/*:refs/remotes/origin/*，强制拉取远程所有分支的引用生成本地远程跟踪记录
• 确认CloneOption里没有开启浅克隆、没有配置分支裁剪规则
  配置修改后重新执行构建，先跑git branch -a确认能看到所有远程分支的跟踪记录，再执行git show-branch就能得到和本地一致的、包含父分支关联提交的输出。

• 如果仓库账号权限不足，没有其他分支的读取权限，就算配置了正确的refspec也拉取不到对应分支引用，可以通过构建日志里的fetch输出确认有没有权限报错。
• 如果之前的工作区有残留配置，可以在构建前加一步deleteDir()清空旧工作区，再重新拉取代码避免旧配置干扰。
• 不需要额外调整showbranch.default相关配置，只要仓库内存在对应分支的引用，命令默认就能正常展示多分支历史。

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