Azure Build Pipeline中发布PR变更文件脚本报错排查

错误原因分析 #

1. fatal: '-' is not a valid branch name：大概率是SYSTEM_PULLREQUEST_SOURCEBRANCH或SYSTEM_PULLREQUEST_TARGETBRANCH环境变量未正确赋值，导致替换后生成无效分支名；也可能是git命令解析时的临时语法错误。
2. ambiguous argument 'origin/master...origin/Prtestdemo': unknown revision or path not in the working tree：核心问题是Azure托管代理默认只拉取PR关联的分支，本地仓库没有origin/$targetBranch或origin/$sourceBranch的远程分支引用，git无法识别这些分支；另外三点语法...的使用场景不匹配当前Pipeline环境的仓库状态。

修复步骤 #

1. 拉取所有远程分支 #

Azure托管代理默认不会拉取所有远程分支，需要先执行git fetch origin确保本地有目标分支和源分支的完整引用。

2. 校验环境变量值 #

在脚本开头增加环境变量输出，确认分支变量是否正确获取，避免因变量为空导致分支名无效：

Write-Host "Source Branch Env: $env:SYSTEM_PULLREQUEST_SOURCEBRANCH"
Write-Host "Target Branch Env: $env:SYSTEM_PULLREQUEST_TARGETBRANCH"

3. 修正git diff语法 #

将三点语法...替换为两点语法..，两点语法用于直接比较两个分支的差异，在Pipeline环境中更可靠；如果坚持使用三点语法，需要确保本地仓库拉取了完整的提交历史（可在Pipeline的git checkout步骤中设置fetchDepth: 0）。

4. 增加空值检查 #

如果没有变更文件，直接退出脚本，避免后续执行报错。

修正后的完整脚本 #

# 输出环境变量确认分支值
Write-Host "Source Branch Env: $env:SYSTEM_PULLREQUEST_SOURCEBRANCH"
Write-Host "Target Branch Env: $env:SYSTEM_PULLREQUEST_TARGETBRANCH"

# 提取分支名（移除refs/heads/前缀）
$sourceBranch = $env:SYSTEM_PULLREQUEST_SOURCEBRANCH.Replace('refs/heads/', '')
$targetBranch = $env:SYSTEM_PULLREQUEST_TARGETBRANCH.Replace('refs/heads/', '')

Write-Host "Processed Source Branch: $sourceBranch"
Write-Host "Processed Target Branch: $targetBranch"

# 拉取所有远程分支引用
git fetch origin

# 获取两个分支间的变更文件（使用两点语法）
$changedFiles = git diff --name-only origin/$targetBranch..origin/$sourceBranch

# 检查是否有变更文件
if (-not $changedFiles) {
    Write-Host "No changed files detected between origin/$targetBranch and origin/$sourceBranch"
    exit 0
}

# 发布变更文件为构建制品
foreach ($file in $changedFiles) {
    $artifactName = Split-Path -Path $file -Leaf
    Publish-BuildArtifact -Path $file -ArtifactName $artifactName -ItemType File
}

# 输出变更文件列表
Write-Host "Changed files:"
foreach ($file in $changedFiles) {
    Write-Host $file
}

额外注意事项 #

• 确认远程分支名称拼写正确（分支名大小写敏感，比如Prtestdemo需和远程仓库中的分支名完全一致）。
• 如果Pipeline中git checkout步骤设置了fetchDepth（默认是1），会导致无法获取完整分支历史，需改为fetchDepth: 0来拉取所有提交记录。

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