无法从Gerrit私有分支的私有Commit拉取Jenkinsfile问题排查

问题核心 #

Jenkins执行Git拉取时未获取到包含目标私有Commit的分支，导致无法找到指定的修订版本，报错Couldn't find any revision to build。

排查与解决步骤 #

1. 验证Gerrit账号权限

确保Jenkins使用的服务账号svc-repo_test-team-sa拥有目标私有分支的读取权限。手动用该账号克隆仓库验证：

git clone ssh://svc-repo_test-team-sa@git-av.company.com:12013/repo_test
cd repo_test
git checkout <你的私有分支名>
git log # 确认目标Commit存在于该分支

2. 调整SCM的Refspec配置

默认Jenkins Git插件仅拉取refs/heads/*下的分支，需修改Refspec确保拉取到目标分支：

• 打开Jenkins Job的SCM配置，点击Advanced展开更多选项
• 在Refspec字段输入：

  +refs/heads/*:refs/remotes/origin/* +refs/heads/<私有分支名>:refs/remotes/origin/<私有分支名>
  

  若不确定分支名，可使用更宽泛的规则拉取所有远程refs：

  +refs/*:refs/remotes/origin/*
  

3. 正确配置Commit拉取方式

直接填写Commit SHA需确保该提交已被拉取，更可靠的配置方式：

• 在Branches to build字段填写私有分支名（如refs/heads/<私有分支名>）
• 添加Additional Behaviors，选择Check out a specific commit，在Commit字段填入目标SHA
• 或直接在Branches to build中填写*/<私有分支名>，确保先拉取整个分支，再切换到目标Commit

4. 确认Jenkinsfile存在于目标Commit

验证目标Commit中是否包含指定路径的Jenkinsfile：

git show <commit_sha_id>:src/jenkins/ci/Jenkinsfile

若输出为空或报错，说明该Commit中无此文件，需重新推送正确的提交。

5. 取消浅克隆配置

如果启用了Shallow clone，可能因历史深度不足无法获取目标Commit：

• 在SCM的Advanced选项中，取消勾选Shallow clone，或增大Depth值至包含目标Commit的历史

补充说明 #

Jenkins不强制要求Jenkinsfile必须在main分支，只要配置正确，任何分支或Commit中的Jenkinsfile都可以被拉取执行，你的问题属于配置疏漏，而非场景不支持。

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