Azure DevOps流水线中Git获取提交变更报错，求解决方案

问题原因分析 #

流水线默认采用浅克隆（仅拉取当前分支最新提交），本地仓库没有main分支的完整历史，导致git diff main报错；手动添加git fetch时，流水线默认凭证可能没有权限拉取远程分支，或浅克隆限制导致无法获取完整分支信息。

方案一：修复git diff的使用 #

1. 调整流水线代码拉取配置 #

编辑流水线的「Get sources」步骤：

• 取消勾选「Shallow fetch」（或设置「Fetch depth」为0，拉取完整仓库）
• 勾选「Fetch all tags and branches」，确保本地能获取到main分支

2. 修改PowerShell脚本 #

将原脚本中的git diff main改为引用远程分支（避免本地分支名不一致问题）：

$changedFiles = git diff origin/main --name-only --relative -- "**/myDefinition.json"
# 后续逻辑保持不变

如果是PR触发的流水线，可以改用Azure DevOps内置变量动态获取目标分支：

# 提取目标分支名（从refs/heads/main转为main）
$targetBranch = $(System.PullRequest.TargetBranch) -replace 'refs/heads/',''
$changedFiles = git diff $targetBranch --name-only --relative -- "**/myDefinition.json"

方案二：改用Azure DevOps API获取变更（无需git命令） #

直接调用Azure DevOps的Build Changes API获取提交的变更文件，规避git分支和凭证问题：

$orgUrl = "$(System.TeamFoundationCollectionUri)"
$project = "$(System.TeamProject)"
$buildId = "$(Build.BuildId)"

# 使用流水线系统令牌认证
$headers = @{
    "Authorization" = "Bearer $(System.AccessToken)"
    "Content-Type" = "application/json"
}

# 调用API获取构建变更
$apiUrl = "$orgUrl$project/_apis/build/builds/$buildId/changes?api-version=7.1-preview.2"
$changes = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method Get

$targetFiles = @()
foreach ($change in $changes.value) {
    foreach ($item in $change.items) {
        # 筛选目标配置文件
        if ($item.path -like "*myDefinition.json") {
            $targetFiles += $item.path
        }
    }
}

if ($targetFiles) {
    $filePath = $targetFiles[0]
    $folderPath = Split-Path -Parent $filePath
    # Azure DevOps路径用正斜杠分隔
    $subFolderName = $folderPath.Split('/')[-1]
    Write-Output "Path to myDefinition.json: $folderPath"
    Write-Output "SubscriptionName: $subFolderName"
} else {
    Write-Error "No myDefinition.json found in the commit."
}

选择建议 #

• 若流水线仅处理分支提交/PR，且仓库体积不大，优先选方案一，逻辑简单直接；
• 若仓库体积大、浅克隆是必须项，或频繁遇到git权限/分支问题，优先选方案二，依赖Azure DevOps原生能力更稳定。

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