使用TortoiseSVN合并分支至主干时部分文件无法合并历史的原因排查

问题背景 #

使用TortoiseSVN执行合并两个不同树操作，将分支（branch）最新版本合并到主干（trunk）最新版本，所有文件内容完全一致、无差异，合并过程无错误提示，但部分文件出现合并历史失败的情况。合并流程如下：

1. 检出代码库至本地
2. 右键选择SVN merge
3. 选择“merge two different tree”模式
4. 设置参数：
   • From URL：主干最新版本路径
   • To URL：分支最新版本路径
   • 工作副本：本地主干路径
   • 合并深度：Working copy
5. 执行合并

可能的原因 #

• 文件存在重命名/移动历史：若问题文件在分支或主干生命周期中被重命名、移动过，SVN的合并追踪机制无法关联其历史版本。即便当前内容完全一致，路径变更会导致SVN无法识别这是同一文件的演进，进而合并历史记录失败。
• 文件版本追踪链断裂：部分文件可能在分支或主干中被删除后重新添加（非SVN标准删除/恢复操作），此时文件UUID会改变，SVN无法将新文件与旧文件的历史关联，合并时自然无法继承完整历史。
• 合并基线版本不匹配：虽选择了最新版本，但如果分支从主干旧版本创建后，主干中部分文件有多次提交，而分支对应文件无任何变更，SVN合并算法可能无法正确匹配两者的历史基线，导致历史合并记录异常。
• 本地工作副本损坏：本地工作副本的.svn缓存目录可能存在损坏，导致合并时无法正确读取或写入历史记录。尝试重新检出干净的工作副本再执行合并，大概率能解决问题。
• 文件属性存在差异：即便文件内容一致，若分支和主干中文件的SVN属性（如svn:mime-type、svn:eol-style）不同，也会干扰合并历史的追踪。SVN处理合并时会考虑属性变更，属性不匹配可能导致历史记录无法正确关联。
• 分支创建不规范：若分支不是通过标准svn copy命令从主干创建，而是手动复制文件后导入的，分支与主干之间未建立正式的父子版本关联，合并时SVN无法识别两者的历史关系，导致部分文件历史合并失败。

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