自建Gitlab CE报503错误提示gitaly socket不存在求助修复

基础状态确认 #

• 执行 gitlab-ctl status gitaly 查看Gitaly服务运行状态，如果PID持续变动、uptime仅为数秒，可确认Gitaly进程处于反复崩溃重启状态，对应socket文件被反复删除重建
• 执行 journalctl -u gitlab-runsvdir.service -f | grep gitaly 抓取Gitaly启动崩溃的实时日志，优先确认崩溃触发的直接原因

常见故障根因及修复 #

根因1：/tmp目录被系统定时清理误删socket #

CentOS 7默认启用systemd-tmpfiles-clean定时服务，会定期删除/tmp目录下长时间未访问的文件，你的报错日志明确显示socket路径在/tmp/gitaly-ruby*/下，大概率是被系统清理任务误删。

• 验证方法：执行 grep "gitaly" /var/log/cron 查看是否有对应目录的清理日志
• 修复步骤：
  1. 编辑 /etc/gitlab/gitlab.rb 配置文件，找到Gitaly socket路径配置项，修改为非/tmp的固定路径：

  gitaly['socket_path'] = '/var/opt/gitlab/gitaly/gitaly.socket'
  

  2. 保存后执行 gitlab-ctl reconfigure 让配置生效，自动重启Gitaly服务

根因2：Gitaly运行目录权限异常 #

Gitaly运行需要对应目录的读写权限，如果目录所有者或权限异常，会导致无法写入socket文件，启动后立刻崩溃。

• 验证方法：执行 ls -ld /var/opt/gitlab/gitaly，确认目录所有者为git:git、权限为755
• 修复步骤：执行 chown -R git:git /var/opt/gitlab/gitaly 修正权限，之后执行 gitlab-ctl restart gitaly 重启服务

根因3：内存不足触发OOM杀掉Gitaly进程 #

如果服务器内存不足，Gitaly处理大仓库/高并发请求时会触发内存溢出，被系统OOM killer主动杀掉。

• 验证方法：执行 dmesg | grep -i oom | grep gitaly 查看是否有Gitaly进程被OOM杀掉的日志
• 修复步骤：编辑 /etc/gitlab/gitlab.rb，调整Gitaly Ruby进程内存上限：

  gitaly['ruby_max_rss'] = 300000000
  

  数值可根据服务器可用内存调整，单位为字节，修改后执行 gitlab-ctl reconfigure 生效

根因4：Gitaly配置文件损坏 #

如果近期修改过GitLab配置未正确生效，可能导致Gitaly配置存在语法错误，无法正常启动。

• 修复步骤：执行 gitlab-ctl reconfigure 重新生成所有组件的配置文件，再执行 gitlab-ctl restart gitaly 重启服务

临时应急方案 #

若需要紧急恢复业务，可先执行 systemctl stop systemd-tmpfiles-clean.timer 临时关闭/tmp目录定时清理，再执行 gitlab-ctl restart 重启所有GitLab服务，恢复访问后再逐步排查根因。

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