Git仓库超容后执行git gc报错pack cannot be mapped是什么原因？

操作前请先完整备份本地整个仓库目录，避免操作失误造成代码丢失。

原因说明 #

你执行git reset --hard后仓库大小没有下降，是因为误提交的大文件仍然保留在Git的reflog引用、悬空对象或者损坏的pack文件中，GC默认不会清理这部分内容；你之前运行GC报错是因为指定pack文件损坏/超过系统内存映射阈值，无法正常读取。

解决方案步骤 #

步骤1：清理残留引用 #

被reset删除的提交会被reflog默认保留30天，先清空这部分引用：

# 过期所有reflog条目
git reflog expire --expire=now --all
# 扫描所有未被引用的悬空对象
git fsck --unreachable --no-reflog

步骤2：移除报错的损坏pack文件 #

将提示无法映射的pack文件和对应索引文件移出Git目录备份，不要直接删除：

# 进入pack文件目录
cd .git/objects/pack
# 移动报错的pack和idx文件到本地临时备份目录（提前自行创建该目录）
mv pack-b863c7c7a902d99d1783551cecaac2264ea22bed.pack /本地临时目录路径/
mv pack-b863c7c7a902d99d1783551cecaac2264ea22bed.idx /本地临时目录路径/

步骤3：执行垃圾回收 #

重新运行GC命令清理冗余对象：

git gc --prune=now --aggressive

如果GC仍报错，改用强制重打包命令：

git repack -a -d -f --depth=250 --window=250

步骤4：验证本地仓库状态 #

清理完成后检查本地.git目录大小是否降到4GB以下，同时确认所有需要的提交历史、代码文件完整无丢失。

步骤5：同步到Bitbucket远端 #

确认本地状态正常后，强制推送覆盖远端提交历史：

git push --force origin 你的对应分支名

如果推送后远端仍提示容量超限，进入Bitbucket对应仓库的设置页面，找到手动触发GC的选项执行远端垃圾回收即可。

备用方案 #

如果上述操作仍无法解决问题，可以直接用官方推荐的大文件清理工具处理：

1. 安装git filter-repo工具
2. 执行命令删除所有历史中的误提交大文件：

git filter-repo --path 你误提交的大文件完整路径 --invert-paths

3. 清理完成后重新推送到Bitbucket即可。

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