Git仓库损坏：缺失tree对象，寻求项目历史修复方案

问题背景 #

• 用Git管理个人项目7年，旧机器硬盘故障后把备份复制到新机器
• 查看主源码文件夹历史时弹出错误：

无法计算Git历史。
缺失tree 714a885cc890d7557277451737c1c2b9547525d8

• 执行git fsck后出现一堆错误，包括空对象文件、缺失对象、broken link：

error: object file .git/objects/af/b1a2fad4670ee56f1d0984c03f926fc248bf09 is empty
error: unable to mmap .git/objects/af/b1a2fad4670ee56f1d0984c03f926fc248bf09: No such file or directory
error: afb1a2fad4670ee56f1d0984c03f926fc248bf09: object corrupt or missing: .git/objects/af/b1a2fad4670ee56f1d0984c03f926fc248bf09
error: object file .git/objects/cd/d1df5c08ff1e8fbacf96e50a7b2580b153c510 is empty
error: unable to mmap .git/objects/cd/d1df5c08ff1e8fbacf96e50a7b2580b153c510: No such file or directory
error: cdd1df5c08ff1e8fbacf96e50a7b2580b153c510: object corrupt or missing: .git/objects/cd/d1df5c08ff1e8fbacf96e50a7b2580b153c510
broken link from    tree e1de2d91314381db3dcebf6d2143742a60fe5d68
              to    tree 714a885cc890d7557277451737c1c2b9547525d8
dangling commit 1400e1f4af9dabc5b089b72ddc9258219e92d139

• gitk能正常显示所有1500+提交，但克隆仓库、执行git gc都解决不了问题

修复步骤 #

1. 找到缺失tree对应的提交 #

先定位哪个提交引用了那个缺失的tree对象714a885cc890d7557277451737c1c2b9547525d8，执行：

git log --all --find-object=714a885cc890d7557277451737c1c2b9547525d8

输出里会列出关联的提交哈希，记下来（比如叫<bad-commit>）。

2. 重建缺失的tree对象 #

既然gitk能看到提交内容，说明该提交的文件内容是可访问的：

1. 切换到这个坏提交的父提交：

   git checkout <bad-commit>^
   

2. 对比父提交和坏提交的差异，搞清楚坏提交里对应的目录结构：

   git diff <bad-commit>^ <bad-commit>
   

3. 根据差异手动恢复对应的目录和文件，然后进入该目录生成新的tree对象：

   git write-tree
   

   执行后会输出一个新的tree哈希（比如<new-tree>），记下来。

3. 替换损坏的提交 #

用git replace临时替换坏提交，避免直接修改历史：

1. 导出坏提交的内容到文件：

   git cat-file commit <bad-commit> > old-commit.txt
   

2. 编辑old-commit.txt，把里面的旧tree哈希（就是714a885...）替换成刚生成的<new-tree>。
3. 导入修改后的提交对象，得到新的提交哈希：

   git hash-object -t commit -w old-commit.txt
   

   输出的哈希记为<new-commit>。
4. 用新提交替换旧提交：

   git replace <bad-commit> <new-commit>
   

5. 现在执行git fsck，检查是否还存在缺失tree的错误。

4. 清理空对象文件 #

针对git fsck里提到的空对象文件，直接删除它们：

find .git/objects -type f -empty -delete

再次执行git fsck确认剩余问题。

5. 永久固化修复（可选） #

如果临时替换后一切正常，想把修改永久写入历史：

git filter-branch -- --all

完成后可以删除临时的replace引用：

git replace -d <bad-commit>

额外建议 #

• 操作前一定要备份当前仓库，防止操作失误导致更严重的损坏
• 如果还有其他备份源（比如旧机器的部分备份、之前推过的远程仓库），优先从备份里复制缺失的对象文件到.git/objects对应的目录（比如缺失的714a885...对应.git/objects/71/4a885cc890d7557277451737c1c2b9547525d8），这是最快的修复方式

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