Azure Pipelines中Git合并分支推送报fetch first错误排查

• 头指针游离（Detached HEAD）：执行git checkout $BRANCH时，如果本地没有对应名称的跟踪分支，Git会直接切到远端跟踪引用origin/$BRANCH上进入游离状态，此时所有合并操作都没有绑定本地分支，引用状态完全不稳定，日志中打印的HEAD detached at origin/task/temp_branch就是直接证据。
• 合并逻辑与需求完全相反：需求是将dev分支合并到指定目标分支，但git merge $BRANCH dev的语义是以当前所在位置为基础，同时合并$BRANCH和dev两个分支的提交，完全不符合预期。
• 代码拉取时机完全错误：在未切换到任何操作分支的初始状态就执行git pull，后续切到dev、切到目标分支后完全没有拉取两个分支的最新远端提交，本地保存的分支版本远落后于远端，推送时自然会因为远端存在本地缺失的提交被拒绝。
• 无意义的冗余步骤：先执行git checkout dev又立刻切走，全程没有对dev分支做拉取、校验操作，这步完全多余，还可能因为本地dev分支缓存过旧引入异常。
• 推送的refspec格式错误：写的推送目标是origin/task/temp_branch，Git refspec规则里远端分支名不需要带origin/前缀，这个写法会把提交推到远端一个名为origin/task/temp_branch的异常分支上，根本不是预期的task/temp_branch。
• 缺少冲突兜底逻辑：脚本没有任何合并冲突判断，一旦两个分支存在冲突，merge命令会停在半合并状态，后续步骤会带着脏工作区继续执行，产生不可预期的结果。

• 操作前先全量同步远端引用：所有分支操作前先执行git fetch --prune origin，将本地所有远端跟踪引用更新到最新状态，不要依赖旧的本地缓存。
• 强制创建本地跟踪分支，从根源避免游离头：切分支时用git checkout -B $BRANCH origin/$BRANCH命令，强制创建/重置本地分支，直接绑定远端对应分支的最新提交，不要直接checkout远端引用。
• 严格校验分支状态后再合并：合并前先通过git rev-parse --abbrev-ref HEAD确认当前就在目标分支上；合并时加--no-edit自动生成合并提交信息，加--no-ff明确保留合并提交轨迹；一旦merge命令返回非零（出现冲突）立刻执行git merge --abort终止流程，让流水线直接失败，不要带着错误状态继续执行。
• 合并完成后先校验再推送：合并完先执行git status确认工作区干净、合并提交已正确生成，再执行推送；推送时用明确的refspec格式git push origin HEAD:refs/heads/$BRANCH，不要用模糊简写，避免推错分支。
• 减少无意义的中转环节：如果最终目标是把dev合入指定分支，直接在本地对应分支完成合并后推到远端对应分支即可，不需要额外推到临时分支做二次中转，减少出错点。
• 最小化权限配置：给流水线使用的构建账号只开放需要合并的目标分支的推送权限，不要开放全仓库强制推送、删除分支权限，避免脚本故障损坏整个仓库。

修正后的参考脚本 #

git config --global user.email "ci-bot@yourdomain.com"
git config --global user.name "CI Auto Merge Bot"

# 同步所有远端最新引用
git fetch --prune origin

# 校验操作的分支都在远端存在
git show-ref --verify --quiet refs/remotes/origin/dev || { echo "远端dev分支不存在，终止流程"; exit 1; }
git show-ref --verify --quiet refs/remotes/origin/$BRANCH || { echo "远端目标分支$BRANCH不存在，终止流程"; exit 1; }

# 强制切到本地目标跟踪分支，基于远端最新版本
git checkout -B $BRANCH origin/$BRANCH
# 保险操作，拉取目标分支最新提交，禁止无关合并
git pull --ff-only origin $BRANCH

# 执行合并，将dev合入当前目标分支
if ! git merge --no-ff --no-edit origin/dev; then
  echo "合并出现冲突，请手动解决后重试"
  git merge --abort
  exit 1
fi

# 校验合并后工作区状态
if [[ -n $(git status --porcelain) ]]; then
  echo "合并后工作区存在未提交变更，异常终止"
  exit 1
fi

# 推送到远端目标分支
git push origin HEAD:refs/heads/$BRANCH

内容的提问来源于stack exchange，提问作者Никита Петров