GitLab仓库异常求助：文件系统存在但页面显示不存在且无法推送

我来帮你解决这个GitLab仓库识别异常的问题——你遇到的核心矛盾是数据库有项目记录、文件系统存在仓库目录，但GitLab UI和推送操作都认为仓库不存在，这基本是项目元数据与实际磁盘路径不匹配，或者GitLab服务缓存/权限异常导致的，下面是分步修复方案：

1. 先检查并重启GitLab服务 #

首先确保GitLab的核心组件都在正常运行，缓存异常也可能导致这种识别错误：

• 查看服务状态：

  sudo gitlab-ctl status
  

  确认gitlab-workhorse、sidekiq、puma（或unicorn）、gitaly这些关键服务都是run状态。
• 如果有异常服务，直接重启整个GitLab：

  sudo gitlab-ctl restart
  

  重启后先刷新UI测试，看仓库状态是否恢复。

2. 验证并修正数据库中的项目磁盘路径 #

你已经确认数据库里有app项目的记录，但大概率是项目的**磁盘路径（disk_path）**元数据错误，导致GitLab找不到实际的仓库目录：

• 进入GitLab Rails控制台：

  sudo gitlab-rails console
  

• 定位到目标项目：

  project = Project.find_by_full_path('root/app')
  

• 查看当前的磁盘路径配置：

  project.disk_path
  

  正常情况下，这个值应该是root/app（对应文件系统路径/var/opt/gitlab/git-data/repositories/root/app.git，GitLab会自动加上.git后缀）。对比你提供的正常项目newname，它的UI显示了正确的文件系统路径，说明它的disk_path是正确的。
• 如果disk_path不对（比如为空、或者是旧的路径），直接修正：

  project.update!(disk_path: 'root/app')
  

• 同时检查仓库存储节点是否正确（默认是default，如果没有自定义存储的话）：

  project.repository_storage
  

  如果不是default，也一并修正：

  project.update!(repository_storage: 'default')
  

• 刷新仓库缓存：

  project.repository.refresh_method_cache
  project.repository.create_if_not_exists
  

• 退出控制台：

  exit
  

3. 修复仓库目录的权限 #

GitLab的服务进程是以git用户运行的，如果仓库目录的权限不对，GitLab也无法访问：

• 修正目录所有者和权限：

  sudo chown -R git:git /var/opt/gitlab/git-data/repositories/root/app.git
  sudo chmod -R 700 /var/opt/gitlab/git-data/repositories/root/app.git
  

• 运行GitLab的配置修复命令，自动同步所有权限和配置：

  sudo gitlab-ctl reconfigure
  

4. 测试修复效果 #

• 刷新GitLab项目详情页，应该能看到文件系统路径和仓库大小正常显示了（和你的newname项目一样）。
• 尝试推送代码到该仓库，验证是否还会出现「A repository for this project does not exist yet」的错误。

补充说明 #

这种问题通常出现在早期GitLab版本迁移、手动修改过仓库目录、或者命名空间变更（比如用户重命名）后，导致项目元数据中的磁盘路径与实际文件系统路径脱节。你对比的newname项目是正常创建的，所以元数据和路径完全匹配，这也验证了我们的修复方向是对的。

内容的提问来源于stack exchange，提问作者Aman Kumar Aggarwal