Git合并报错fatal: refusing to merge unrelated histories如何调整工作流修复

报错根因 #

fatal: refusing to merge unrelated histories报错的核心原因是三个长期分支没有共同的祖先提交，通常是分支初始化时未从同一根节点拉取，或中途被硬重置到了无关提交导致。

一、当前分支状态修复 #

操作前先给所有分支打备份标签，避免操作失误丢失代码：

git tag backup-dev origin/development
git tag backup-test origin/test
git tag backup-prod origin/production
# 后续操作出错可执行 `git reset --hard [标签名]` 恢复

修复步骤（无需使用cherry-pick） #

1. 对齐test与production分支历史
   切换到test分支并拉取最新代码：

   git checkout test
   git pull origin test
   

   合并production分支，添加允许无关历史参数：

   git merge production --allow-unrelated-histories
   

   按常规流程解决合并冲突后提交，推送到远程test分支：

   git push origin test
   

2. 对齐development与test分支历史
   切换到development分支并拉取最新代码：

   git checkout development
   git pull origin development
   

   合并已对齐历史的test分支：

   git merge test --allow-unrelated-histories
   

   解决冲突后提交并推送到远程development分支即可。
   完成上述操作后，三个分支已具备共同祖先节点，后续合并不会再触发无关历史报错。

二、后续工作流调整规则 #

要永久避免该问题，需严格遵守以下分支管理规则：

• 长期分支初始化必须基于同一根节点：首次搭建分支体系时，先创建production分支，再从production拉取test分支，最后从test拉取development分支，确保三个分支从初始阶段就共享提交历史
• 所有功能/修复分支必须从development分支拉取，开发完成后仅合并回development分支，禁止跨长期分支拉取开发分支
• 严格遵守development → test → production的合并链路，禁止跳级合并，禁止反向从上游分支（如production）直接合并代码到下游分支（如development）
• 禁止对三个长期分支执行git reset --hard到分支链路外的提交，禁止强制推送覆盖远程长期分支的提交历史；需要回滚代码时使用git revert生成反向提交，保证提交历史连续性
• 每次合并操作前先拉取目标分支的最新远程代码，保证本地分支与远程同步后再执行合并

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