Jenkins提示找不到实际存在的Git分支feature/show-percentage-of-completion如何解决

1. Jenkins Git拉取逻辑说明 #

Jenkins默认不采用git clone + git checkout的全量操作，是为了复用工作区减少磁盘占用、提升构建速度，完整流程逻辑如下：

• 执行git --version确认Git版本兼容性，避免不同版本命令差异导致执行失败
• 执行git fetch拉取远端所有分支的最新引用，同步本地缓存和远端状态
• 执行git rev-parse校验指定分支的commit哈希是否存在，提前确认分支有效性，避免后续checkout流程出错

2. 报错根因 #

报错提示Couldn't find any revision to build的核心原因是：Jenkins完成远端引用拉取后，未找到对应origin/feature/show-percentage-of-completion分支的有效commit记录。
注意：你本地.git/config文件的分支配置仅适用于你的本地开发环境，和Jenkins服务器上的Git运行环境完全独立，不影响Jenkins的拉取逻辑

3. 排查解决步骤 #

• 第一步：确认分支已推送到远端，在你的本地开发环境执行命令：
  git ls-remote origin feature/show-percentage-of-completion
  如果无输出结果，说明你仅在本地创建了分支未推送到远端，执行git push origin feature/show-percentage-of-completion推送后重新构建即可。
• 第二步：检查Jenkins项目配置中的分支名称，确认没有拼写错误、大小写偏差，Git分支名称大小写敏感，任何字符不一致都会导致找不到分支。
• 第三步：检查Jenkins Git插件的refspec配置：进入项目配置的「源码管理」→「Git」→「Additional Behaviours」，添加「Advanced clone behaviours」，确认refspec字段为默认值+refs/heads/*:refs/remotes/origin/*，如果被修改过可以重置为默认值，或手动添加目标分支的refspec：+refs/heads/feature/show-percentage-of-completion:refs/remotes/origin/feature/show-percentage-of-completion
• 第四步：清理Jenkins工作区缓存：进入Jenkins项目详情页，点击「清理工作空间」清除残留的旧Git缓存，之后重新触发构建。
• 第五步：临时测试方案：可以勾选「轻量检出」选项，轻量检出会直接拉取指定分支的Jenkinsfile，不需要全量同步所有远端引用，可以绕过大部分分支引用查找类问题。

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