因历史已删除大文件导致Git推送失败的问题求助

问题根源 #

虽然deployment_20200220.sql已被删除，但它仍然存在于Git的历史提交记录中。GitHub推送时会检查所有历史对象，该文件超过100MB的大小限制，导致推送被拒绝。

方法一：用git filter-repo彻底移除历史中的大文件 #

这是最彻底的解决方案，会重写分支历史以完全清除目标文件的痕迹：

1. 安装git filter-repo（通过系统包管理器如apt install git-filter-repo、brew install git-filter-repo或官方源码安装）
2. 执行命令移除目标文件：

   git filter-repo --path deployment_20200220.sql --invert-paths
   

3. 强制推送修改后的分支到远程：

   git push origin feature-branch --force
   

注意：此操作会改变分支历史，若有其他协作者在该分支工作，需通知他们重新拉取并同步本地分支。

方法二：重构分支历史（适合首次迁移场景） #

由于这是首次推送到新的GitHub仓库，可直接保留需要的提交，跳过包含大文件的历史：

1. 切换到master分支并新建临时分支：

   git checkout master
   git checkout -b temp-feature
   

2. 将特性分支的有效提交逐个cherry-pick到临时分支（跳过涉及大文件的旧提交）：

   git cherry-pick <特性分支的提交哈希值>
   

3. 用临时分支替换原特性分支：

   git checkout feature-branch
   git reset --hard temp-feature
   

4. 推送修改后的分支：

   git push origin feature-branch --force
   

后续预防措施 #

• 更新.gitignore文件，添加*.sql（或指定大文件规则），避免后续提交类似大文件
• 推送前可提前检查历史中的大文件，命令如下：

  git rev-list --objects --all | grep "$(git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -10 | awk '{print$1}')"
  

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