Git Flow流程中热修复分支合并develop时重引入旧变更问题排查
Git Flow 热修复合并到develop时重新引入废弃变更的原因排查
问题场景还原
- 团队日常Git Flow落地规范:基于
develop分支创建release分支,正式发布完成后将release分支双向合并回develop与master,历史多次发布均未涉及热修复操作 - 本次首次触发热修复:按照流程从
master分支切出hotfix分支完成线上故障修复,合并回master的流程一切正常 - 合并异常表现:尝试将
hotfix分支合并到develop时,diff比对显示会向develop重新引入已废弃的旧变更——多个本应在develop分支中删除的文件,会在合并完成后被重新添加回分支 - 前置校验条件:本次合并操作前,
staging对应的代码分支与master完全一致,无任何代码差异 - 排查限制:过往合并操作较多,分支历史过于杂乱,暂时无法提供清晰的提交图谱辅助排查
异常的核心成因
该问题本质是Git自动识别的合并基点(merge base)出现偏差,叠加分支历史链路断裂导致的,拆解下来逻辑非常直白:
- 先明确Git合并的基础逻辑
执行git merge <source>将source分支合并到当前分支时,Git会自动定位两个分支的最近共同祖先节点作为合并基准,基于「共同祖先的文件快照、当前分支的最新快照、source分支的最新快照」三者做差异比对,自动完成合并。Git不会自动追溯两个分支上久远的历史变更,只会基于识别到的共同基点计算diff——如果基点找错了,合并结果必然和预期不一致。 - 历史操作埋下的隐患
团队过往的发版流程中,将release分支合并回master时,大概率没有走标准的三方合并流程,常见的操作偏差包括:- 直接将
master分支强制对齐到release的代码快照(比如执行git checkout master && git reset --hard release-xxx后强制推送) - 合并时使用
--strategy=ours参数,完全保留master的旧代码,不引入release分支的任何变更 - 合并出现冲突时,人工选择把
master的旧代码完整保留,没有把release上的最新代码真正同步过去
这类操作会导致master分支的提交历史和develop分支的提交历史彻底断裂:master上的提交节点不会出现在develop的提交链路里,两个分支除了最早期的初始仓库节点外,没有任何其他共享的提交节点。
- 直接将
- 触发异常的完整路径
- 从断裂的
master分支切出hotfix分支时,hotfix完全继承了master的旧代码快照——这些快照里自然还保留着那些后来在develop分支上被删除的废弃文件 - 当尝试把
hotfix合并回当前的develop时,Git因为两个分支历史断裂,根本找不到最近的、真实的共同祖先,只能定位到最早期的初始仓库节点作为合并基点 - 这个最早期的初始节点上,根本不存在这些已经被废弃的文件。Git做三方diff时会判定:
hotfix分支相对于这个最老的基点,是「新增了这些废弃文件」;而当前develop分支相对于这个最老的基点,也没有这些文件——Git完全记不起来develop曾经加过这些文件、后来又删掉的操作,因为计算diff的起点实在太老了 - 最终Git就会把这些废弃文件,判定为
hotfix分支需要引入的新变更,自动加入到develop的合并结果里,也就是观察到的“重新引入已废弃旧变更”的现象。
- 从断裂的
简化的时间线参考:
- 仓库初始节点(两个分支唯一的共同祖先):只有基础配置,无业务文件
develop分支从初始节点出发,陆续加入业务代码、废弃文件A/B,后期迭代中删除A/B,持续开发- 每次发版将release合并回master时,没有打通提交链路,master的提交是独立生成的,快照中保留了A/B,但提交记录和develop无关联
- 从这样的master切出hotfix,带着A/B的代码,合并回develop时Git只能定位到最早期的初始节点做diff,自然会把hotfix里的A/B判定为需要引入的新变更
临时规避与长期修正建议
- 本次热修复合并时,不要直接让Git自动完成合并,可执行
git merge hotfix --no-commit暂停合并流程,逐文件核对diff,手动排除所有被错误判定为新增的废弃旧文件,确认无误后再提交合并结果 - 后续优化发版流程:每次合并
release分支到master时,强制使用标准的三方合并流程,不做强制reset、跳过差异比对的操作,确保master和develop的提交链路打通,让Git能正确识别两个分支的真实共同祖先,避免后续热修复再出现同类问题
内容的提问来源于stack exchange,提问作者Jerome Ortega
相关产品推荐
相关产品推荐

