GitLab CE自托管实例：清理无法删除的占位用户及修复项目权限

这些「Placeholder Name Surname」占位用户是从GitLab.com导入项目时生成的——当自托管实例中不存在GitLab.com上的对应用户（比如外部协作者、未同步的内部用户），GitLab会自动创建占位账号替代，进而导致权限混乱。以下是具体解决办法：

一、合并占位用户到现有账号（核心方案） #

GitLab CE UI没有用户合并功能，必须通过Rails控制台操作，步骤如下：

1. 登录GitLab服务器，启动Rails控制台：

gitlab-rails console

2. 定位目标用户与占位用户：
   替换示例中的邮箱/名称，找到你要保留的真实用户和对应的占位用户：

# 找到真实用户
target_user = User.find_by(email: 'real-user@your-domain.com')
# 找到对应占位用户（可通过用户列表里的邮箱确认，占位用户邮箱多为自动生成的local地址）
placeholder_user = User.find_by(name: 'Placeholder Name Surname', email: 'placeholder_1234@gitlab.local')

3. 执行合并：

Users::MergeService.new(target_user, placeholder_user).execute

合并后，占位用户的所有项目权限、提交记录、活动都会迁移到目标用户，占位账号会被标记为待删除。

4. 批量合并（谨慎使用，先测试单个）：
   如果有大量占位用户，可通过循环批量匹配合并（需根据你的用户邮箱规则调整匹配逻辑）：

# 筛选所有占位用户
placeholder_users = User.where(name: 'Placeholder Name Surname')
placeholder_users.each do |pu|
  # 假设占位用户的原前缀对应真实用户邮箱，比如占位邮箱是xxx@gitlab.local，真实邮箱是xxx@your-domain.com
  target_email = pu.email.split('@')[0] + '@your-domain.com'
  target_user = User.find_by(email: target_email)
  if target_user
    Users::MergeService.new(target_user, pu).execute
    puts "已合并占位用户 #{pu.id} 到 #{target_email}"
  else
    puts "未找到 #{pu.email} 对应的真实用户"
  end
end

二、删除无对应真实用户的占位账号 #

如果部分占位用户没有匹配的真实用户，确认他们没有关联重要权限/提交后，可直接删除：

1. 单个删除：

# 先找到占位用户
pu = User.find_by(id: 123) # 替换为占位用户ID
pu.destroy!

2. 批量删除无关联的占位用户：

User.where(name: 'Placeholder Name Surname').each do |pu|
  # 检查是否无项目关联和成员权限
  if pu.projects.empty? && pu.members.empty?
    pu.destroy!
    puts "已删除无关联占位用户 #{pu.id}"
  else
    puts "跳过 #{pu.id} - 该用户仍有活跃权限/项目关联"
  end
end

三、修复项目权限混乱 #

1. 合并/删除占位用户后，进入每个项目的「设置→成员」页面，手动清理冗余的权限条目，确保权限分配给正确的真实用户。
2. 批量调整权限可通过GitLab API：

# 示例：更新指定项目中用户的权限为开发者（access_level=30）
curl --request PUT \
  --header "PRIVATE-TOKEN: 你的管理员Token" \
  "https://你的GitLab地址/api/v4/projects/项目ID/members/用户ID" \
  --data "access_level=30"

权限等级对应：10=访客，20=Reporter，30=开发者，40=维护者，50=所有者

四、避免后续导入出现占位用户 #

下次从GitLab.com导入前：

• 先从GitLab.com导出用户列表（「管理员→用户→导出」），批量导入到自托管实例。
• 导入项目时，确保勾选「匹配现有用户」选项，让GitLab自动关联已有账号，避免生成占位符。

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