Git提交大文件导致Push被拒绝的问题排查与解决方法_其他编程

为什么会出现这个情况?

因为这个代码是二开的,从别的代码仓库下载zip的方式下载的
并且里面没有.gitignore
在我们远程仓库没有创建好的情况下我现在本地仓库已经提交了几次代码了,导致提交了jar包上去
现在要往新建出远程仓库第一次推送的时候出现了这次的问题
所以本次演示的删除 git 提交历史中的大文件
如果是删除未提交的文件直接使用git rm --cached即可

在使用 git 推送代码到远程仓库（比如 gitee）时，经常会遇到这样的问题：

remote: find the desired index: <hash>, size: 108.596mb, exceeds quota 100mb
error: failed to push some refs to 'https://gitee.com/your-repo.git'
! refs/heads/master:refs/heads/master [remote rejected] (pre-receive hook declined)

这是因为 git 历史中存在大文件，超出了远程仓库的限制。本文将详细讲解如何排查并解决此问题。

一、问题分析

大文件导致 push 被拒绝
gitee/github 等平台对单个文件大小有限制（gitee 默认 100mb）。如果历史提交中存在大文件，就算你在最新提交里删除了，也无法直接 push。
普通 git rm --cached 不起作用
仅删除工作区或暂存区的文件，并不会删除 git 历史里的大文件。

二、排查大文件

在 windows powershell 中，可以使用如下命令找出仓库中最大的文件：

git rev-list --objects --all | `
  git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | `
  where-object { $_ -match "^blob" } | `
  sort-object {[int]($_.split(" ")[2])} -descending | `
  select-object -first 20

输出示例：

注意：这里显示的文件大小是字节数。你可以找到所有超出远程限制的文件。

三、删除大文件

1. 使用git rm --cached删除最新提交的文件

从 git 暂存区（索引）中删除指定文件，但保留工作目录中的文件。

git rm --cached path/to/largefile
git commit -m "remove large file from latest commit"

这种方法只能删除最新提交中的大文件，历史提交中仍然存在。

2. 删除 git 历史中的大文件

使用git filter-branch

警告：这会重写 git 历史，如果其他人已经克隆了仓库，会导致冲突。确保你是唯一开发者或者团队同意重写历史。

# 执行 filter-branch 删除历史中的大文件
git filter-branch --force --index-filter `
"git rm --cached --ignore-unmatch im-admin/ruoyi-admin/target/im-admin.jar" `
--prune-empty --tag-name-filter cat -- --all

3. git filter-branch时有uncommitted changes解决方案

注意：

windows 下需要确保暂存区没有文件被 staged，否则会报错。
删除完成后，需要强制 push：
如果暂存区有文件被 staged 就会出现如下图所示报错

查看当前仓库的状态

 git status

将暂存区（staging area）中的 .ds_store 文件撤回到未暂存状态，也就是取消 git add 对 .ds_store 的操作，但不会删除工作目录中的文件。

git restore --staged .ds_store

最后使用 git filter-branch 对git 历史中的大文件进行删除

删除成功后再次推送就能成功推送了

git push origin master --force

四、预防措施

添加 .gitignore 忽略临时文件和 target 目录

# maven
**/target/
*.jar

# macos
.ds_store

使用 git lfs 管理大文件(可选)
对于必须提交的大文件（>100mb），可以使用 git lfs 来管理。

git lfs install
git lfs track "*.jar"

五、总结

push 被拒绝原因：仓库历史中存在大文件。
排查方法：使用 git rev-list + git cat-file 查找最大文件。
解决方法：
1. 删除暂存区大文件：git rm --cached
2. 删除历史大文件：git filter-branch 或 git filter-repo
预防措施：使用 .gitignore、git lfs。