如何按已分配角色搜索用户并导出指定角色用户列表

我做权限系统运维和二次开发时碰过好几次这个需求，整理几个经过实际验证的可行路径，对照自己的使用环境选就行：

• 有系统数据库操作权限的场景（比如自建开源系统、私有化部署的商用平台）
  绝大多数角色权限体系都是三张核心表结构：用户表（通常命名为user/users）、角色表（通常命名为role/roles）、用户角色关联映射表（通常命名为user_role/user_role_rel），直接跑关联SQL就能捞出全量对应数据，通用查询示例如下：

  SELECT u.user_id, u.username, u.email, u.department, r.role_name
  FROM user u
  INNER JOIN user_role_rel rel ON u.user_id = rel.user_id
  INNER JOIN role r ON rel.role_id = r.role_id
  WHERE r.role_name = '你需要查询的特定角色名称'
  -- 如果是按角色ID查就替换成 WHERE r.role_id = '目标角色ID'，准确度更高
  

  查询结果直接在数据库管理工具里选择导出，支持CSV、Excel等多种格式，不用费劲找前端菜单里的导出按钮——80%的系统根本没把这个功能做在可见的前端入口里。
• 无数据库权限、但平台开放了开放接口的场景（比如SaaS类服务、统一身份管理平台）
  查平台官方接口文档找「查询指定角色下关联用户」的接口，拿到鉴权凭证后写个简单脚本拉取全量数据即可，极简Python实现示例：

  import requests
  import csv
  
  # 替换为你自己的实际配置信息
  API_TOKEN = "你的接口访问鉴权token"
  TARGET_ROLE_ID = "要导出用户的目标角色ID"
  API_URL = f"https://你的平台服务域名/openapi/role/{TARGET_ROLE_ID}/users"
  REQUEST_HEADER = {"Authorization": f"Bearer {API_TOKEN}"}
  
  user_list = []
  current_page = 1
  while True:
      request_params = {"page": current_page, "page_size": 100}
      response = requests.get(API_URL, headers=REQUEST_HEADER, params=request_params).json()
      user_list.extend(response["data"]["items"])
      if current_page >= response["data"]["total_pages"]:
          break
      current_page += 1
  
  # 结果写入本地CSV文件
  with open("特定角色关联用户列表.csv", "w", encoding="utf-8-sig", newline="") as f:
      writer = csv.DictWriter(f, fieldnames=user_list[0].keys())
      writer.writeheader()
      writer.writerows(user_list)
  

  正式拉全量数据前先拿测试角色试跑一次，确认返回的用户范围正确，避免出现漏数、混进其他角色用户的问题。
• 既无数据库权限、也无可用开放接口的场景
  直接打开系统前端的角色管理页面，选中目标角色查看关联用户列表，把分页大小调到最大值，全选表格内容直接复制粘贴到本地Excel里就行，适合用户量小的场景，不用折腾复杂实现。

翻遍KB和论坛找不到现成方案很正常，这类偏运维侧的小众需求很少有厂商单独写进公开文档，不用死等官方出前端导出按钮，上面三个方法基本能覆盖90%以上的使用场景。

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