GitLab无法推送多个/较大文件，已尝试多种方法仍未解决
2026-5-22
解决GitLab推送多文件/大文件失败的问题
嘿，我来帮你捋捋这个GitLab推送的问题～既然单个小文件能正常推送，说明基础的Git配置、仓库权限和网络连接没毛病，问题大概率出在推送大小限制或者网络传输稳定性上，给你几个针对性的排查方向：
1. 检查GitLab仓库的文件大小限制
GitLab默认对单个文件和总推送大小有门槛，你可以这么操作：
- 登录GitLab网页端，进入你的仓库，点「Settings」→「Repository」，找到「File size limit」选项，看看是不是设了太小的阈值（比如比你要推的文件还小）
- 如果是自己搭的GitLab服务器，还得检查服务器配置：
- 编辑GitLab主配置文件（一般是
/etc/gitlab/gitlab.rb） - 找到
gitlab_rails['git_max_size']和nginx['client_max_body_size']这俩配置项，把数值调大（比如改成500m代表500MB） - 执行
sudo gitlab-ctl reconfigure和sudo gitlab-ctl restart让配置生效
- 编辑GitLab主配置文件（一般是
2. 调整本地Git的推送缓存设置
有时候本地Git的缓存不够会导致大文件推送失败，试试这俩命令：
- 设置推送缓存为500MB：
git config --global http.postBuffer 524288000 - 关闭压缩提升稳定性：
git config --global core.compression 0
3. 换SSH方式推送（替代HTTPS）
HTTPS推送有时候会因为网络验证或者传输中断出问题，换成SSH试试：
- 在GitLab网页端生成SSH密钥对，把公钥加到你的账户「Settings」→「SSH Keys」里
- 本地仓库切换远程地址为SSH：
git remote set-url origin git@gitlab.com:username/your-repo.git
之后再推送应该就不用每次输账号密码了，还能提升传输稳定性
4. 排查仓库里的隐藏大文件
有时候仓库里可能藏着你没注意的大文件（比如之前提交过后来加进.gitignore但没移除追踪的文件），你可以：
- 执行
git ls-files --size-sort | tail -10看看仓库里最大的10个文件 - 如果发现意外的大文件，用
git rm --cached large-file-name移除追踪，再重新提交推送
最后试试分段推送
要是以上方法都不管用，那就把文件拆成小批次推：
- 先加一部分文件：
git add file1 file2 - 提交：
git commit -m "Push part 1" - 推送：
git push origin master - 重复步骤推完剩下的文件
内容的提问来源于stack exchange，提问作者trouselife
相关产品推荐
相关产品推荐
