使用git-filter-repo修复提交后git fsck仍报错的问题排查

核心原因 #

git-filter-repo重写提交历史时，会生成全新的合法提交链，但原有的坏提交对象并不会自动从Git对象库中删除：

• 这些旧对象属于「悬空对象」，但只要还有引用（比如分支reflog、未删除的标签、stash）指向它们，git fsck扫描整个对象库时就会检测到这些旧的错误提交。
• 你用git cat-file -p <旧哈希>看到的“正确格式”大概率是混淆了哈希值——Git对象哈希是内容的SHA-1校验和，内容修改后哈希必然改变，你实际查看的可能是重写后的新提交对象，而非原有的坏对象。

解决步骤 #

1. 清除所有历史引用
   执行以下命令清理分支的reflog记录（reflog会保存分支的历史状态，包括修改前的旧提交哈希）：

   git reflog expire --expire=now --all
   

2. 强制垃圾回收
   让Git彻底清理所有未被引用的悬空对象（包括原有的坏提交）：

   git gc --prune=now
   

3. 重新验证
   再次运行检查命令，确认错误已消除：

   git fsck --full
   

额外注意事项 #

• 如果仓库存在未清理的标签、stash或其他远程分支引用，需要先删除或同步这些引用，否则旧对象可能仍被保留。
• git-filter-repo执行后，务必确保所有本地分支都切换到重写后的新分支，避免残留对旧提交的引用。

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