如何在自有或管理的GitLab群组及关联项目中查找并移除指定用户

当然有办法！手动逐个项目排查确实太繁琐了，我之前帮不少团队处理过类似的批量成员清理需求，推荐用GitLab API+脚本的方式来搞定，效率拉满。下面给你详细的操作步骤：

准备工作 #

首先你需要生成一个GitLab个人访问令牌，权限要勾选：

• api（核心API访问权限）
• read_user（获取用户信息）
• write_group（修改群组成员）
• write_project（修改项目成员）
  可以在GitLab的「个人设置」→「访问令牌」里创建，记得保存好令牌，刷新页面后就看不到了。

方案：Python脚本批量处理 #

下面是一个现成的Python脚本，你只需要替换几个参数就能用：

import requests

# 替换成你的GitLab实例地址（如果是GitLab云就是https://gitlab.com）
GITLAB_URL = "https://your-gitlab-instance.com"
# 替换成你刚生成的个人访问令牌
ACCESS_TOKEN = "your-personal-access-token"
# 替换成你要查找的目标用户名
TARGET_USERNAME = "the-user-you-want-to-remove"

headers = {"PRIVATE-TOKEN": ACCESS_TOKEN}

def get_all_groups():
    """获取你拥有或管理的所有群组（包括子群组）"""
    groups = []
    page = 1
    while True:
        response = requests.get(
            f"{GITLAB_URL}/api/v4/groups",
            headers=headers,
            params={"owned": True, "page": page, "per_page": 100}
        )
        response.raise_for_status()
        current_page_groups = response.json()
        if not current_page_groups:
            break
        groups.extend(current_page_groups)
        page += 1
    return groups

def get_group_projects(group_id):
    """获取指定群组下的所有项目"""
    projects = []
    page = 1
    while True:
        response = requests.get(
            f"{GITLAB_URL}/api/v4/groups/{group_id}/projects",
            headers=headers,
            params={"page": page, "per_page": 100, "include_subgroups": True}
        )
        response.raise_for_status()
        current_page_projects = response.json()
        if not current_page_projects:
            break
        projects.extend(current_page_projects)
        page += 1
    return projects

def get_user_id(username):
    """根据用户名获取用户ID"""
    response = requests.get(
        f"{GITLAB_URL}/api/v4/users",
        headers=headers,
        params={"username": username}
    )
    response.raise_for_status()
    users = response.json()
    if users:
        return users[0]["id"]
    else:
        print(f"未找到用户 {username}")
        return None

def remove_user_from_group(group_id, user_id):
    """从群组移除用户"""
    try:
        response = requests.delete(
            f"{GITLAB_URL}/api/v4/groups/{group_id}/members/{user_id}",
            headers=headers
        )
        if response.status_code == 204:
            print(f"成功从群组ID {group_id} 移除用户 {TARGET_USERNAME}")
        elif response.status_code == 404:
            print(f"用户 {TARGET_USERNAME} 不在群组ID {group_id} 中")
    except Exception as e:
        print(f"移除群组ID {group_id} 中的用户失败: {e}")

def remove_user_from_project(project_id, user_id):
    """从项目移除用户"""
    try:
        response = requests.delete(
            f"{GITLAB_URL}/api/v4/projects/{project_id}/members/{user_id}",
            headers=headers
        )
        if response.status_code == 204:
            print(f"成功从项目ID {project_id} 移除用户 {TARGET_USERNAME}")
        elif response.status_code == 404:
            print(f"用户 {TARGET_USERNAME} 不在项目ID {project_id} 中")
    except Exception as e:
        print(f"移除项目ID {project_id} 中的用户失败: {e}")

if __name__ == "__main__":
    user_id = get_user_id(TARGET_USERNAME)
    if not user_id:
        exit()
    
    print("开始扫描所有群组和项目...")
    groups = get_all_groups()
    for group in groups:
        group_id = group["id"]
        print(f"处理群组: {group['name']} (ID: {group_id})")
        # 先处理群组本身的成员
        remove_user_from_group(group_id, user_id)
        # 处理群组下的所有项目
        projects = get_group_projects(group_id)
        for project in projects:
            project_id = project["id"]
            print(f"  处理项目: {project['name']} (ID: {project_id})")
            remove_user_from_project(project_id, user_id)
    
    print("所有扫描和处理操作完成！")

使用注意事项 #

1. 先测试再执行：可以先把脚本里的remove_user_from_group和remove_user_from_project函数改成只打印信息，不执行删除操作，确认所有要移除的用户位置都正确后，再开启删除功能。
2. 权限验证：确保你的令牌拥有足够的权限，否则会出现403禁止访问的错误。
3. 分页处理：脚本里已经做了分页逻辑，不用担心群组/项目太多导致漏扫。
4. 子群组支持：脚本会自动扫描子群组下的项目，不用单独处理。

如果你不想写代码，也可以用GitLab的「群组导出」功能导出所有成员数据，然后用Excel筛选目标用户，再手动处理，但这种方式还是不如脚本高效，适合小体量的群组/项目。

内容的提问来源于stack exchange，提问作者crimson-egret