git push --mirror间歇性失败求助：AWS CodeCommit同步内部GitHub镜像异常

1. 解析git push --mirror的报错根源 #

git push --mirror的核心行为是同步所有本地引用（分支、标签等）到远程，同时删除远程存在但本地缺失的引用。报错refusing to delete the current branch: refs/heads/master说明：

• 执行同步时，本地Git认为自己没有master分支的引用，因此尝试删除GitHub仓库的master分支
• 但GitHub禁止删除当前设置的默认分支（这里是master），所以推送被拒绝

2. 排查CodeBuild的仓库克隆环节 #

之前稳定运行，近期出现异常，优先检查克隆步骤的变化：

• 确认构建脚本中克隆CodeCommit仓库的命令：如果使用的是普通git clone而非git clone --mirror，本地只会拉取默认分支，且不会创建完整的本地分支引用（仅存在origin/master远程跟踪分支），这会导致push --mirror误判要删除远程的master分支
• 检查构建环境的缓存残留：CodeBuild是否复用了旧的仓库目录？如果之前的构建残留了异常的分支引用，会导致本次同步时状态混乱。可以在克隆前添加rm -rf <仓库目录>强制清理

3. 验证本地仓库的引用状态 #

在CodeBuild构建脚本中添加调试命令，输出本地引用详情：

git branch -a
git show-ref

重点确认：

• 是否存在本地master分支（refs/heads/master），而非仅存在远程跟踪分支origin/master（refs/remotes/origin/master）
• 本地所有分支引用是否与CodeCommit仓库完全一致

4. 检查GitHub仓库的配置 #

• 确认内部GitHub仓库的默认分支是否为master：如果曾经修改过默认分支再改回，可能存在状态异常
• 查看分支保护规则：默认情况下GitHub会禁止删除默认分支，这是正常的，但要确认是否有其他规则影响分支推送

5. 临时替代同步方案（避免--mirror的删除逻辑） #

如果需要先恢复同步，同时继续排查根源，可以替换git push --mirror为以下命令：

git push --all git@git.companyname.com:TeamOrg/project-x.git
git push --tags git@git.companyname.com:TeamOrg/project-x.git

--all仅推送本地所有分支，不会删除远程分支；--tags同步所有标签，既满足镜像需求，又避免触发删除操作。

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