Linux环境下GitLab的常见问题及解决

一、安装与配置问题

1. 依赖安装失败：安装GitLab时可能因缺少policycoreutils-python、openssh-server、postfix等依赖包报错。解决方法：使用系统包管理器安装缺失依赖（如CentOS下sudo yum install -y policycoreutils-python openssh-server postfix）；若遇libsemanage-static或libsemanage-devel缺失（常见于SELinux配置错误），需安装对应包并重新配置。
2. 配置文件错误：修改/etc/gitlab/gitlab.rb（如设置external_url）时，语法错误或配置项无效会导致服务异常。解决方法：仔细检查配置文件格式（如引号、缩进），修改后执行sudo gitlab-ctl reconfigure重新应用配置。
3. 端口冲突：GitLab默认使用80（HTTP）、443（HTTPS）、8080（unicorn）等端口，若被其他服务占用，会导致无法访问。解决方法：通过netstat -tulnp | grep 端口号确认端口占用进程，修改/etc/gitlab/gitlab.rb中的端口设置（如nginx['listen_port'] = 9099），然后重启GitLab服务。
4. 防火墙未放行：CentOS等系统的防火墙（firewalld）可能阻止GitLab端口访问。解决方法：开放必要端口（如sudo firewall-cmd --permanent --add-service=https --add-service=http），然后sudo firewall-cmd --reload。

二、权限与认证问题

1. Permission Denied（权限不足）：无法克隆、推送代码或访问仓库目录，多因用户对目录无读写权限。解决方法：检查仓库目录权限（如/var/opt/gitlab/git-data/repositories），使用chown -R git:git /path/to/repo将所有权赋予Git用户，或用chmod调整权限（如chmod 755 /path/to/dir）。
2. SSH认证失败：使用SSH克隆时提示“Permission denied (publickey)”，因SSH密钥未正确配置。解决方法：本地生成密钥对（ssh-keygen -t rsa -b 4096 -C "your_email@example.com"），将公钥（~/.ssh/id_rsa.pub）添加到GitLab用户设置的SSH Keys中。
3. 500 Internal Server Error：GitLab页面显示500错误，多为后端服务（如unicorn、数据库）异常。解决方法：查看GitLab日志（/var/log/gitlab/gitlab-rails/production.log）定位具体错误（如数据库连接失败、代码异常），根据日志修复问题。

三、性能问题

1. 系统资源不足（卡顿、死机）：CPU、内存占用过高导致GitLab响应慢或崩溃。解决方法：使用top、htop命令查看资源占用，关闭不必要的进程；增加服务器资源（如升级CPU、内存）；启用Swap分区（sudo fallocate -l 2G /swapfile，sudo chmod 600 /swapfile，sudo mkswap /swapfile，sudo swapon /swapfile）。
2. 数据库卡顿：PostgreSQL数据库性能瓶颈（如慢查询、索引缺失）导致GitLab操作延迟。解决方法：定期清理数据库（gitlab-rake gitlab:db:gc）；优化数据库索引（使用EXPLAIN ANALYZE分析慢查询）；调整PostgreSQL配置（如shared_buffers设为内存的25%-40%，work_mem设为4MB-16MB）。
3. 访问慢：网络延迟或GitLab配置不合理导致页面加载慢。解决方法：启用缓存（如Redis，配置gitlab_rails['redis_cache_instance'] = "redis://127.0.0.1:6379"）；优化GitLab配置（如调整unicorn['worker_processes']为CPU核心数的1-2倍，unicorn['worker_timeout']设为60秒）；使用CDN加速静态资源。

四、日常运维问题

1. 服务无法启动：GitLab服务（如unicorn、gitaly）无法启动，多因配置错误或进程阻塞。解决方法：使用sudo gitlab-ctl status查看服务状态，停止所有服务（sudo gitlab-ctl stop），删除阻塞文件（如/var/opt/gitlab/gitaly/gitaly.pid），再重新启动（sudo gitlab-ctl start）。
2. 日志管理：日志文件过大占用磁盘空间。解决方法：配置日志轮转（修改/etc/gitlab/gitlab.rb中的gitlab_rails['log_rotate_frequency'] = 'daily'，gitlab_rails['log_max_size'] = '200MB'），然后sudo gitlab-ctl reconfigure；定期清理过期日志（sudo find /var/log/gitlab -type f -name "*.log" -mtime +7 -delete）。
3. 数据备份与恢复：未定期备份导致数据丢失。解决方法：配置自动备份（sudo gitlab-rake gitlab:backup:create），设置备份目录（gitlab_rails['backup_path'] = '/var/opt/gitlab/backups'），定期测试恢复流程（sudo gitlab-rake gitlab:backup:restore BACKUP=timestamp）。