Azure DevOps PR触发流水线更新README推送分支失败排查

一、分支名格式修正 #

$(system.pullRequest.sourceBranch)变量默认返回带refs/heads/前缀的分支路径（如refs/heads/callerid），需要提取干净的分支名：

Bash环境下提取分支名 #

SOURCE_BRANCH=$(echo "$(system.pullRequest.sourceBranch)" | sed 's/refs\/heads\///')

PowerShell环境下提取分支名 #

$sourceBranch = "$(system.pullRequest.sourceBranch)" -replace 'refs/heads/', ''

二、推送失败问题解决 #

推送失败的核心原因是本地分支未同步远程分支的最新变更，需调整Git操作流程，确保先拉取最新代码再提交推送：

完整修正后的Git命令（Bash示例） #

# 1. 提取干净分支名
SOURCE_BRANCH=$(echo "$(system.pullRequest.sourceBranch)" | sed 's/refs\/heads\///')

# 2. 切换到源分支并拉取远程最新代码
git checkout $SOURCE_BRANCH
git pull origin $SOURCE_BRANCH

# 3. 执行readme.md更新操作（替换为你实际的更新逻辑）
# 示例：比如通过脚本生成或修改README内容
# ./update-readme-script.sh

# 4. 提交变更
git add readme.md
git commit -m "更新README - 部署版本 $(Build.BuildNumber) [skip ci]"

# 5. 推送到远程源分支
git push origin $SOURCE_BRANCH

关键调整说明 #

1. 移除无效配置：删除原命令中的git config --global init.defaultbranch $(system.pullRequest.sourceBranch)，该配置仅在初始化仓库时生效，对已克隆的仓库无意义。
2. 切换并拉取分支：先切换到源分支，再拉取远程最新代码，确保本地分支与远程分支同步，避免推送时因版本落后被拒绝。
3. 精准提交文件：将git add .改为git add readme.md，仅提交README的变更，避免意外提交其他文件。
4. 添加[skip ci]标签：防止推送后再次触发流水线，避免循环执行。

三、额外权限配置 #

确保Azure DevOps流水线的服务账号拥有源分支的推送权限：

• 进入仓库的「设置」→「存储库权限」
• 找到流水线对应的服务账号（格式为项目名称 Build Service）
• 授予其「Contribute」权限

内容的提问来源于stack exchange，提问作者Călimanu Loredan