Jenkins构建报错找不到可构建修订版本，该如何排查原因？

报错原文：Couldn't find any revision to build. Verify the repository and branch configuration for this job.

该报错核心原因是Jenkins无法从配置的代码仓库中匹配到可构建的提交版本，未改动配置仍触发报错的常见原因如下：

• 远端仓库分支状态变更
  你Jenkins任务配置的对应分支在远端被删除、重命名，或者仓库默认分支名称被修改（比如从master改为main），即使Jenkins侧配置没有改动，也会出现找不到对应分支版本的问题。如果配置的是通配符分支匹配规则（比如*/feature/*），若当前远端没有符合匹配规则的活跃分支，也会触发该报错。
• 本地仓库缓存损坏
  Jenkins工作节点本地存储的仓库缓存文件损坏、.git目录丢失/权限异常，或者节点磁盘空间已满无法写入新的代码信息，都会导致Jenkins无法正常识别分支的提交记录。可直接删除对应任务的工作空间目录后重新构建验证。
• 仓库访问权限异常
  Jenkins配置的仓库拉取账号权限被回收、访问密钥/Token过期，会导致Jenkins无法读取仓库的分支列表，进而抛出找不到修订版本的报错。如果是多节点构建场景，还需要确认报错的工作节点是否单独配置了仓库访问权限。
• 仓库连通性问题
  远端仓库访问地址变更、网络策略调整导致Jenkins节点无法正常连接代码仓库时，也会出现该报错。可在对应Jenkins工作节点手动执行git ls-remote <你的仓库地址>命令，验证是否能正常拉取到分支列表。
• 构建前置配置异常
  如果开启了Merge before build这类前置合并配置，要检查待合并的源分支是否被删除、源分支和目标分支是否存在无法自动解决的冲突，这类情况也会触发该报错。

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