Azure Pipeline Git镜像因分离头触发GH002错误，求全分支标签推送方案

我明白你碰到的这个头疼问题了——Azure Pipeline在运行时会检出特定提交，导致仓库处于**分离头（detached HEAD）**状态，这直接让你的镜像推送命令踩了GitHub的分支命名限制坑，抛出GH002错误。

问题到底出在哪？ #

当Pipeline执行git checkout <SHA>后，Git会自动在refs/remotes/origin/下生成一个指向该SHA的临时引用（比如origin/6ADFB183A4A2C94A2F92DAB5ADE762A47889A5A1）。你原来的推送命令git push mirror --progress --prune +refs/remotes/origin/*:refs/heads/*会把origin/下的所有引用都同步到镜像仓库的分支里，自然就包含了这个临时的SHA命名的“伪分支”，而GitHub明确禁止40位十六进制字符的分支名称，所以直接报错了。

两种靠谱的解决办法 #

要绕开这个问题，核心就是只推送源仓库的正式分支和标签，别带上Pipeline生成的临时引用。这里有两种实用方案：

方案1：直接推送本地分支和标签（简单直接）

修改你的命令，跳过refs/remotes/origin/*，直接针对本地的分支和标签进行推送：

# 添加镜像目标仓库的远程地址
git remote add --mirror=fetch mirror MIRROR_REPO

# 推送所有正式分支到镜像仓库
git push mirror --progress --prune +refs/heads/*:refs/heads/*

# 推送所有标签到镜像仓库
git push mirror --prune +refs/tags/*:refs/tags/*

这里用refs/heads/*直接指向源仓库的本地分支，完全不会包含那些临时的SHA引用，从根源上避免了命名冲突。

方案2：重新拉取完整的源仓库引用（更稳妥）

如果担心Pipeline的本地仓库状态被修改，建议先重新从源仓库拉取所有分支和标签，确保拿到的是最完整的正式引用：

# 先清理可能存在的旧镜像远程（避免冲突）
git remote remove mirror || true

# 添加镜像目标仓库的远程地址
git remote add mirror MIRROR_REPO

# 从源仓库拉取所有分支和标签，覆盖本地对应引用
git fetch origin '+refs/heads/*:refs/heads/*' '+refs/tags/*:refs/tags/*' --prune

# 把所有分支和标签推送到镜像仓库，同步删除已不存在的引用
git push mirror '+refs/heads/*:refs/heads/*' '+refs/tags/*:refs/tags/*' --prune

这种方法完全不受Pipeline分离头状态的影响，确保镜像的是源仓库的完整状态。

额外提醒 #

• 一定要确保Pipeline使用的服务账号对镜像仓库有完整的推送权限，包括创建/删除分支、推送标签的权限
• --prune参数很重要，它会自动删除镜像仓库中源仓库已经不存在的分支和标签，保持两边完全同步

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