Git Push操作失败问题求助——大文件量项目首次推送至远程仓库报错

嘿，我看你们小文件测试完全正常，但6000个文件的项目一推就报错，结合共享存储的环境，大概率是存储特性或者Git配置拖了后腿，下面给你们几个针对性的排查方向，一步步来试试：

1. 先查共享存储的文件系统和权限 #

共享存储大概率用了SMB、NFS这类网络文件系统，它们有时候不支持Git裸仓库依赖的硬链接或者精细权限控制，而大项目推送时Git会频繁用到这些特性：

• 先看挂载参数：用mount命令看看共享存储是怎么挂载的，比如：

  mount | grep 你的共享存储挂载路径
  

  如果是SMB挂载，没开unix extensions的话就会出问题，试试卸载后重新挂载：

  sudo umount /mnt/your-shared-folder
  sudo mount -t cifs //server-ip/share-path /mnt/your-shared-folder -o username=your-user,password=your-pass,unix extensions=yes
  

• 再查裸仓库的权限：确保运行Git的用户对远程裸仓库有读写执行权限，用ls -ld /path/to/your-bare-repo看权限，得是drwxr-xr-x这种，要是权限不对，用chmod -R 755 /path/to/your-bare-repo调一下，同时确认用户组也对得上。

2. 调整Git的打包推送配置 #

大项目推送时Git会生成超大的打包文件，可能触发存储的限制或者解压故障：

• 先试试关闭增量推送，强制全量推（临时测试用）：

  git push -u Name master --no-thin
  

  默认的--thin会减少传输量，但有些存储对这种增量操作支持不好，关掉说不定就好了。
• 再把打包文件拆小一点，降低压力：
  在本地仓库里执行这两句：

  git config pack.windowMemory 100m
  git config pack.packSizeLimit 50m
  

  这样Git会生成多个小打包文件，推送时就不容易出问题。

3. 检查共享存储的空间和配额 #

小文件测试占空间少，但大项目推送时裸仓库需要临时空间来解压打包文件，说不定是空间不够或者配额超限了：

• 用df -h /path/to/your-bare-repo看看剩余空间，至少得留项目大小1.5倍以上的空间才够。
• 问问存储管理员，你们的用户有没有磁盘配额限制，会不会是推的时候触发了配额上限。

4. 换个方式初始化远程裸仓库 #

要是上面的方法都不行，可以试试直接在共享存储本地先把项目提交好，再转成裸仓库：

# 先登录到共享存储所在的服务器操作
cd /path/to/shared-storage
git init temp-repo
cd temp-repo
# 把本地项目的文件复制到这里（或者用scp传过来）
cp -r /local/project/path/* .
git add .
git commit -m "Initial project commit"
# 转换成裸仓库
git config --bool core.bare true

然后把本地仓库的远程地址改成这个新的裸仓库，再推送后续变更，这样绕开了网络推送时的打包解压步骤，说不定能解决问题。

最后别忘了验证一下：找另一台电脑克隆这个远程仓库，看看所有文件都能正常拉取，没损坏没缺失就没问题了。

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