GitLab自托管环境下批量推送LFS文件失败求助

环境与问题背景 #

• 基于AWS EC2部署的自托管GitLab
• 服务器与客户端均安装GitLFS v3.3.0
• 少量.obj文件推送正常，批量推送大量.obj文件失败
• 推送LFS相关提交必须添加--no-verify参数，否则触发其他错误

报错详情 #

终端推送失败提示：

! [remote rejected]   v0.0.1/lfs/objs_2 -> v0.0.1/lfs/objs_2 (pre-receive hook declined)
error: failed to push some refs to "server.ip.here:gitlab-group-name/repo-name.git"

GitLab日志文件gitlab-tail.log中出现401未授权错误，但使用同一密钥分批推送10-15个相同文件时无异常。

可能原因 #

1. LFS授权令牌过期：批量推送耗时较长，超过默认令牌有效期，后续文件上传时触发401，进而被pre-receive hook拦截。
2. pre-receive hook校验限制：GitLab内置或自定义的pre-receive hook对批量LFS文件的校验逻辑存在阈值，文件过多时校验过程出现授权失效或超时。
3. EC2资源/网络瓶颈：批量推送时服务器CPU、内存占满，或网络不稳定，导致LFS服务响应超时触发401。

解决步骤 #

1. 延长LFS令牌有效期 #

修改GitLab服务器配置，延长授权令牌的有效时长：

• 编辑GitLab主配置文件（通常路径为/etc/gitlab/gitlab.rb）
• 添加或更新以下配置项：

  gitlab_rails['lfs_token_expiry'] = 3600 # 单位为秒，设置为1小时，可根据实际推送时长调整
  

• 重新配置并重启GitLab服务：

  sudo gitlab-ctl reconfigure
  sudo gitlab-ctl restart
  

2. 调整pre-receive hook逻辑 #

• 若使用自定义pre-receive hook：登录GitLab服务器，进入对应仓库的hooks目录（路径示例：/var/opt/gitlab/git-data/repositories/gitlab-group-name/repo-name.git/hooks），检查pre-receive脚本中是否有LFS文件数量限制或校验授权逻辑，调整阈值或优化授权方式。
• 若为GitLab内置hook：尝试升级GitLab到最新稳定版本，这类批量推送的问题可能已在后续版本中修复。

3. 优化EC2资源与推送并发数 #

• 检查EC2实例的CPU、内存使用率，若批量推送时资源耗尽，升级实例规格（增加CPU核数或内存）。
• 在客户端限制LFS并发上传数，降低服务器压力：

  git config lfs.concurrenttransfers 5 # 将默认并发数10调整为5，可根据情况进一步降低
  

4. 临时分批推送（应急方案） #

若上述方法暂未生效，可分批次推送文件，每批控制在20个以内，同时保持添加--no-verify参数。

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