如何修复Git（搭配GitLFS）中未打包对象文件过大问题？

一、先定位异常对象的来源 #

1. 批量识别x开头Git对象的类型与大小 #

运行以下命令，批量获取所有x开头对象的哈希、类型（blob/tree/commit/tag）和大小：

git cat-file --batch-check='%(objectname) %(objecttype) %(objectsize)' < <(find .git/objects/x -type f | sed 's/\.git\/objects\///;s/\///')

如果结果里大量是blob类型，说明这些是大文件内容，大概率是未被Git LFS追踪、或构建过程中临时生成的文件被误纳入Git对象库。

2. 查找对象关联的提交/引用 #

针对单个大对象哈希（比如xabc123...），用以下命令查找哪个提交或引用包含它：

# 查找包含该对象的所有提交
git log --all --find-object=xabc123...
# 查找所有引用指向的对象中包含该哈希的条目
git rev-list --objects --all | grep xabc123...

如果是批量处理，可以把所有x开头的对象哈希导出到文件，再逐个排查：

find .git/objects/x -type f | sed 's/\.git\/objects\///;s/\///' > x-objects.txt
while read hash; do echo "Checking $hash:"; git log --all --find-object=$hash; done < x-objects.txt

3. 检查构建过程中的误操作 #

• 查看构建代理的工作目录，是否有构建生成的超大临时文件（比如编译产物、日志包）被Git暂存：git status
• 检查是否有未清理的stash：git stash list，用git stash show -p <stash-name>查看stash内容是否包含大文件

二、针对性清理方案 #

1. 强制清理无引用的对象（reflog残留导致gc失效） #

默认git gc会保留最近90天的reflog记录，先强制清理所有不可达的reflog，再执行gc：

# 清理所有不可达的reflog条目
git reflog expire --expire-unreachable=now --all
# 强制清理所有无引用的对象
git gc --prune=now --aggressive

2. 移除无用的stash或本地分支 #

如果排查到stash包含大对象，直接删除：

git stash drop <stash-name>

查看所有本地分支，删除构建过程中临时创建的无用分支：

git branch -D <branch-name>

3. 取消暂存未跟踪的大文件 #

如果git status显示有超大文件被暂存，取消暂存并删除：

git reset HEAD <large-file-path>
rm -rf <large-file-path>

4. 补全Git LFS追踪配置（如果是漏追踪的大文件） #

如果发现某些大文件未被LFS追踪，先将其加入LFS配置：

git lfs track "<file-pattern>"
git add .gitattributes
git commit -m "Track large files with LFS"

之后再清理旧的Git对象（需要确保这些对象已无引用），重新执行git gc --prune=now。

5. 检查构建代理的Git配置 #

确保构建代理的Git配置没有阻止自动清理：

git config --list | grep -E "gc\.auto|prune\.expire"

如果gc.auto值过高（比如大于10000），可以调低让Git更频繁自动gc；prune.expire如果设置为远大于默认的90天，改为now或更短周期。

内容的提问来源于stack exchange，提问作者AJ Henderson