Azure Pipelines多仓库场景下Git checkout失败问题咨询

配置了多仓库检出的Azure Pipelines YAML流水线，运行时出现Git checkout失败错误，但仅默认检出单仓库时无异常。

流水线配置代码 #

resources:
  repositories:
  - repository: repName
    type: git
    ref: branchname
    name: project/repo

jobs:
- job: prerequisite
  timeoutInMinutes: 120
  displayName: Setup variables
  steps:
  - checkout: self
  - checkout: repName

错误输出 #

HEAD is now at 72bc708d Update azure-pipelines.yml for Azure Pipelines
##[warning]Git checkout failed on shallow repository, this might because of git fetch with depth '1' doesn't include the checkout commit 'refs/remotes/origin/85hgf1234754b65aaadc947c195313b626a4bb72'. Please reference documentation (http://go.microsoft.com/fwlink/?LinkId=829603)
##[error]Git checkout failed with exit code: 1

原因分析 #

• Azure Pipelines默认使用浅克隆（fetchDepth=1），仅拉取仓库的最新一次提交，以此提升流水线运行速度。
• 单仓库场景下，默认检出的是流水线所在仓库的当前分支，浅克隆的最新提交正好匹配，因此能正常完成检出。
• 多仓库场景中，指定的repName仓库的ref（分支/提交）可能不在浅克隆的范围内：比如目标分支的最新提交未被浅克隆拉取，或者要检出的提交是历史提交，浅克隆仅拉取了最新1次提交，无法找到目标提交，导致检出失败。

解决方案 #

在checkout步骤中显式设置fetchDepth参数，拉取完整仓库历史或足够深度的提交：

1. 拉取完整仓库历史（推荐，避免历史提交依赖问题）：

steps:
- checkout: self
  fetchDepth: 0
- checkout: repName
  fetchDepth: 0

2. 若明确所需提交的深度，可设置具体数值（比如拉取最近100次提交）：

steps:
- checkout: self
  fetchDepth: 100
- checkout: repName
  fetchDepth: 100

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