Gitlab CE误升级后降级出现500错误及数据库迁移不兼容问题求助

问题根源 #

你误升级到14.8版本时，GitLab执行了一个关键数据库迁移：把services表重命名为integrations。但降级回13.10.5后，这个版本的代码仍然期望使用services表，而数据库里只剩integrations表，这就导致了找不到表的500错误——简单说就是代码版本和数据库结构不匹配了。

解决步骤（务必先备份！） #

1. 先备份当前数据库

这是所有数据库操作的前提，绝对不能跳过：

# 使用GitLab自带的备份工具
gitlab-backup create
# 或者直接用postgres命令做更直接的备份
pg_dump -U gitlab gitlabhq_production > gitlab_db_backup_$(date +%Y%m%d).sql

2. 手动将integrations表改回services

GitLab的降级流程不会自动回滚高版本的迁移，所以需要手动在数据库中调整结构：

• 进入GitLab的数据库控制台：

  gitlab-rails dbconsole
  

• 执行表重命名SQL：

  ALTER TABLE integrations RENAME TO services;
  

• 重命名相关索引（在psql里输入\d services可以查看所有索引，逐个修改）：

  # 示例：根据你实际的索引名调整，把所有带integrations的索引改成services
  ALTER INDEX index_integrations_on_type_and_title RENAME TO index_services_on_type_and_title;
  ALTER INDEX index_integrations_on_project_id RENAME TO index_services_on_project_id;
  

• 重命名序列（如果存在的话）：

  ALTER SEQUENCE integrations_id_seq RENAME TO services_id_seq;
  

• 检查并修复外键约束：如果其他表有引用integrations的外键，需要更新外键指向services表，比如：

  # 示例：假设某个表有integrations_id外键，先删除旧约束再添加新约束
  ALTER TABLE some_table DROP CONSTRAINT some_table_integrations_id_fkey;
  ALTER TABLE some_table ADD CONSTRAINT some_table_services_id_fkey FOREIGN KEY (integrations_id) REFERENCES services(id);
  

3. 验证数据库迁移状态

执行命令确认所有迁移都匹配13.10.5版本：

gitlab-rake db:migrate:status

确保所有标记为up的迁移都是13.10.5版本包含的，没有14.x的迁移残留。

4. 重启GitLab服务

gitlab-ctl restart

5. 测试功能

现在尝试创建新组，应该不会再出现500错误了。

注意事项 #

• GitLab官方不推荐降级操作，除非是紧急情况。升级前一定要做好备份，并且严格遵循官方的升级路径（比如13.10.x → 13.11.x → 14.0.x → ... → 14.8.x），跨版本升级很容易导致迁移冲突。
• 如果之后需要再次升级，一定要先确保当前数据库和代码版本完全匹配，再按照官方路径逐步升级。

内容的提问来源于stack exchange，提问作者Alaindeseine