如何排查debian gitlab错误

下面按常见场景给你一个在 Debian 上排查 GitLab 错误的系统化思路，从“先看哪里”到“常见错误怎么处理”。

一、先看 GitLab 自身状态（最重要）

1. 查看 GitLab 服务状态

sudo gitlab-ctl status

正常应看到：

run: nginx
run: puma
run: sidekiq
run: postgresql
run: redis

如果有 down，说明对应组件挂了。

2. 查看整体健康情况

sudo gitlab-rake gitlab:check

会检查：

权限
仓库目录
数据库连通性
配置文件问题

常见提示：

permission denied → 文件权限问题
database connection failed → PostgreSQL 问题

二、看日志（定位错误核心）

1. 实时查看所有日志

sudo gitlab-ctl tail

适合刚发生错误时看。

2. 分组件看日志

sudo gitlab-ctl tail nginx
sudo gitlab-ctl tail puma
sudo gitlab-ctl tail sidekiq
sudo gitlab-ctl tail postgresql

三、Web 页面报错的常见原因

1. 502 / 无响应

可能原因：

puma 没起来
内存不足（OOM）
端口被占用

排查：

free -h
sudo gitlab-ctl status puma
sudo gitlab-ctl tail puma

2. 500 错误

看：

sudo gitlab-ctl tail puma
sudo gitlab-rake gitlab:check

常见：

数据库迁移未完成

sudo gitlab-rake db:migrate

四、Git 操作报错（push / clone 失败）

1. SSH 无法连接

检查：

sudo gitlab-ctl status sshd

以及：

/etc/ssh/sshd_config
GitLab SSH 端口配置

测试：

ssh -T git@your-gitlab-domain

2. HTTP / HTTPS 报错

看 nginx：

sudo gitlab-ctl tail nginx

常见：

证书过期
反向代理配置错误

五、配置文件问题

主配置文件：

sudo vim /etc/gitlab/gitlab.rb

修改后必须重新加载：

sudo gitlab-ctl reconfigure

⚠️ 没执行 reconfigure 是常见坑。

六、数据库问题（PostgreSQL）

查看数据库状态：

sudo gitlab-ctl status postgresql

日志：

sudo gitlab-ctl tail postgresql

连接测试：

sudo gitlab-rake gitlab:db:configure

七、系统层面排查（Debian）

1. 磁盘空间

df -h

GitLab 非常吃磁盘。

2. 内存

free -h

官方最低 4G，2G 很容易崩。

3. 系统日志

sudo journalctl -xe

八、常见错误速查表

现象	原因	排查命令
502	puma/nginx 挂	`gitlab-ctl status`
500	数据库/代码	`gitlab:check`
push 失败	SSH/权限	`gitlab-ctl tail sshd`
页面打不开	端口/防火墙	`ss -tulnp`
升级后异常	未 migrate	`gitlab-rake db:migrate`

九、如果你愿意，我可以进一步帮你

你可以直接贴：

具体报错信息
GitLab 版本
Debian 版本
是 页面错误 / git 操作错误 / 启动失败

我可以按你的情况给你精准排查步骤。