新安装GitLab进入Admin Area>CI/CD页面出现变量获取错误

问题描述 #

新部署GitLab CE实例（测试过gitlab/gitlab-ce:15.0.0-ce.0及最新版本），进入Admin Area > CI/CD页面时，页面提示：

There was an error fetching the variables

附相关截图：

排查与解决步骤 #

• 查看核心日志定位根因
  直接过滤GitLab容器日志中的错误信息：

  docker logs <你的GitLab容器ID/名称> | grep -i "error"
  

  或进入容器查看更精准的Rails业务日志：

  docker exec -it <容器ID/名称> bash
  cat /var/log/gitlab/gitlab-rails/production.log | grep -i "ci/variables"
  

  日志会明确显示是数据库连接异常、权限不足还是API逻辑报错。

• 检查容器资源与目录权限
  GitLab最低需分配4G内存（官方推荐8G），内存不足会导致请求超时；同时确保宿主机挂载的GitLab数据目录权限正确：

  chown -R 998:998 /srv/gitlab  # 998是容器内git用户的默认UID/GID
  

  权限错误会直接导致数据库、缓存读写失败。

• 清理缓存并重启服务
  脏缓存是这类页面报错的常见诱因，执行以下命令：

  docker exec -it <容器ID/名称> gitlab-rake cache:clear
  docker exec -it <容器ID/名称> gitlab-ctl restart
  

  重启后刷新页面重试。

• 验证数据库状态
  检查数据库连接与表完整性：

  docker exec -it <容器ID/名称> gitlab-rake db:check
  

  若提示未完成数据库迁移，手动执行：

  docker exec -it <容器ID/名称> gitlab-rake db:migrate
  

• 直接测试API接口
  使用管理员私人令牌测试CI变量API，排除前端页面问题：

  curl --header "PRIVATE-TOKEN: <你的管理员私人令牌>" http://<GitLab访问地址>/api/v4/admin/ci/variables
  

  若API返回错误，说明是后端服务问题；若返回正常变量列表，清空浏览器缓存后重试即可。

内容的提问来源于stack exchange，提问作者Mohammad Reza Mousavi