GitLab 15.2.2删除用户后无法重建同名用户的问题求助

问题原因 #

直接执行User.delete(3)属于硬删除数据库记录，并未触发GitLab内部的完整删除回调，导致用户名缓存、关联的个人命名空间、保留用户名列表等残留资源未被清理，系统因此判定用户名已被占用。

解决步骤 #

1. 清理残留的用户命名空间 #

进入gitlab-rails console，执行以下命令：

# 查找同名用户的个人命名空间
namespace = Namespace.find_by(path: 'myusername')
# 若存在则彻底删除
namespace.destroy if namespace.present?

2. 清除GitLab缓存 #

在GitLab服务器终端（无需进入rails console）执行：

# 清除应用缓存
sudo gitlab-rake cache:clear
# 清除Redis缓存
sudo gitlab-redis-cli FLUSHALL

3. 检查并移除保留用户名列表 #

回到gitlab-rails console，执行：

# 检查用户名是否被加入保留列表
reserved = ReservedUsername.where(name: 'myusername')
# 若存在则删除记录
reserved.destroy_all if reserved.present?

4. 重新尝试创建用户 #

完成上述操作后，即可正常创建同名用户。

注意事项 #

• 尽量避免直接使用User.delete(id)删除用户，优先通过GitLab后台界面删除，或在rails console中执行user.destroy（会触发完整删除逻辑，自动清理所有关联资源）。
• 操作前建议备份GitLab数据库，防止误操作导致数据丢失。

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