centos gitlab为何报502错误

在 CentOS 上部署 GitLab 出现 502 错误，通常不是 GitLab 本身坏了，而是后端服务没有正常响应（最常见是 Unicorn / Puma、Nginx、PostgreSQL、Redis 等问题）。下面按最常见原因 → 排查方法 → 解决方式来说明。

一、最常见原因（90% 情况）

1️⃣ GitLab 服务还没启动完（刚装完 / 刚重启）

GitLab 启动慢，第一次访问 502 是正常的。

✅ 解决：

gitlab-ctl status

等待所有服务为 run 状态，尤其是：

• unicorn 或 puma
• sidekiq
• nginx
• postgresql

一般等 1–3 分钟再访问。

2️⃣ 内存不足（最常见！）

GitLab 官方最低要求 4GB 内存，2GB 基本必 502。

✅ 检查：

free -h

如果 swap 也没，直接 OOM。

✅ 解决：

• 加内存
• 或开启 swap
• 或降低 GitLab 资源占用（见后文）

3️⃣ Unicorn / Puma 端口或进程异常

GitLab 内部服务没起来，Nginx 就会返回 502。

✅ 查看日志：

gitlab-ctl tail unicorn
# 或
gitlab-ctl tail puma

常见错误：

• timeout
• cannot bind port
• permission denied

4️⃣ Nginx 配置错误或端口冲突

比如：

• 80 端口被占用
• 自定义 Nginx 没配对

✅ 检查：

gitlab-ctl tail nginx
netstat -lntp | grep 80

✅ 解决：

• 停止其他占用 80 的服务（如 httpd）

systemctl stop httpd

5️⃣ PostgreSQL 没起来

数据库挂了，GitLab 直接 502。

✅ 查看：

gitlab-ctl status postgresql
gitlab-ctl tail postgresql

6️⃣ 磁盘满了（非常容易被忽略）

df -h

GitLab 日志一多就爆盘。

✅ 解决：

gitlab-ctl cleanse
# 或清日志

二、快速自检清单（照着做）

# 1. 看整体状态
gitlab-ctl status

# 2. 看错误日志
gitlab-ctl tail

# 3. 看内存
free -h

# 4. 看端口
netstat -lntp

# 5. 重启（必要时）
gitlab-ctl restart

三、低内存服务器优化（2GB 也能跑）

编辑：

vi /etc/gitlab/gitlab.rb

puma['worker_processes'] = 2
sidekiq['concurrency'] = 10
postgresql['shared_buffers'] = "256MB"

然后：

gitlab-ctl reconfigure
gitlab-ctl restart

四、典型结论

CentOS GitLab 502 = 后端服务没起来 核心三件事：内存够、服务起、端口没冲突

如果你愿意，可以贴出：

• gitlab-ctl status
• gitlab-ctl tail 的最后 20 行

我可以帮你精准定位是哪一步挂了。