Git推送Rails应用报错log/development.log过大，清理后仍报错求助

你遇到的问题其实很常见——哪怕你现在把本地的log/development.log清空了，Git的提交历史里还保留着这个大文件的旧版本。Git在推送时会检查仓库所有历史对象的大小，所以历史里的大文件依然会触发这个报错。

下面是具体的解决步骤，一步步来就能彻底解决：

1. 确认.gitignore配置正确 #

你已经添加了log到.gitignore，但最好再确认下规则是否覆盖到位：
打开.gitignore，确保有以下任意一条规则：

log/
# 或者更精确的
log/*.log

如果规则没问题，提交这个配置：

git add .gitignore
git commit -m "Update gitignore to exclude log files"

2. 彻底从Git历史中移除大文件 #

你之前用的git filter-branch虽然能用，但现在更推荐用git filter-repo（它更稳定、速度更快）。如果还没安装，根据你的系统安装：

• macOS：brew install git-filter-repo
• 其他系统：pip install git-filter-repo

安装完成后，执行命令彻底移除历史里的log/development.log：

git filter-repo --path log/development.log --invert-paths

3. 清理Git本地缓存和冗余数据 #

执行以下命令清理本地Git的冗余对象，确保彻底删除历史里的大文件痕迹：

git reflog expire --expire=now --all
git gc --prune=now --aggressive

4. 强制推送到远程仓库 #

因为你修改了Git的提交历史，所以需要强制推送覆盖远程仓库的旧历史：

git push origin main --force  # 把main换成你的实际分支名，比如master

重要提醒 #

如果是多人协作的项目，一定要提前告诉其他开发者，让他们先备份本地修改，然后执行git fetch origin和git reset --hard origin/main（对应分支名）来同步新的历史，避免代码冲突。

内容的提问来源于stack exchange，提问作者Mamadou Ali