为何Azure DevOps按提交ID而非PR引用拉取PR代码？

问题背景 #

团队将两个独立仓库合并为monorepo后，原有的PR gated-build YAML脚本（用于仅测试PR变更内容）出现fatal: Needed a single revision错误。脚本逻辑是通过git rev-parse --verify HEAD~1获取上一个提交ID，再执行增量测试，但由于Azure DevOps（ADO）现在通过单个提交ID（带--depth=1）拉取PR代码，导致无法找到HEAD的父提交。

对比新旧仓库的拉取日志：

• 旧仓库拉取PR合并引用：

  git --config-env=http.extraheader=env_var_http.extraheader fetch --force --tags --prune --prune-tags --progress --no-recurse-submodules origin  +refs/heads/*:refs/remotes/origin/* +refs/pull/8847/merge:refs/remotes/pull/8847/merge
  

• 新仓库拉取单个提交：

  git --config-env=http.extraheader=env_var_http.extraheader fetch --force --tags --prune --prune-tags --progress --no-recurse-submodules origin --depth=1 +f77dbabe86180eabf1a9a0ebe3450ed4afe67eab:refs/remotes/origin/f77dbabe86180eabf1a9a0ebe3450ed4afe67eab
  

行为差异的原因 #

1. Git历史不连续：合并两个独立仓库后，新仓库的Git历史包含两段无关联的提交序列，ADO的PR构建机制可能因无法识别PR分支与目标分支的连续历史，自动切换为轻量化的单提交拉取策略。
2. 管道浅克隆配置：合并仓库后可能误开启了ADO管道的“浅克隆”选项，或者默认浅克隆深度被设置为1，导致仅拉取当前提交而不包含父提交。
3. ADO对monorepo的默认策略调整：当仓库体积或历史复杂度大幅提升时，ADO可能默认采用更高效的拉取方式，优先拉取PR的头部提交而非完整的merge引用。

解决方案 #

1. 调整ADO管道的获取源设置 #

• 进入ADO管道的编辑页面，找到“获取源”步骤。
• 取消勾选“浅克隆”选项，或者将浅克隆深度设置为至少2（确保能获取到HEAD的父提交）。
• 确认PR构建的源引用设置为refs/pull/{PullRequestId}/merge，而非单个提交ID。

2. 改用ADO内置变量获取基准提交 #

避免依赖HEAD~1，直接使用ADO提供的PR相关变量获取目标分支的基准提交：

# 获取PR目标分支的最新提交ID
TARGET_COMMIT=$(git rev-parse origin/${System.PullRequest.TargetBranch})
npm run branch && vitest run --changed $TARGET_COMMIT

3. 手动拉取足够的历史 #

在测试脚本前添加拉取命令，确保能获取到必要的提交历史：

# 拉取当前分支最近2个提交的历史
git fetch --depth=2 origin $(git rev-parse --abbrev-ref HEAD)
# 再执行原测试逻辑
BRANCH=$(git rev-parse --verify HEAD~1) && echo testing branch $BRANCH
npm run branch && vitest run --changed $BRANCH

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