Keycloak导出用户超时问题：如何获取全部用户数据？

分页查询（优先推荐） #

不要用max=-1一次性拉取全部17万用户，Keycloak的/users接口原生支持分页参数，通过first（起始偏移量）和max（单次拉取数量）分批获取数据。示例请求：

• 第一批：{realms}/users?first=0&max=1000
• 第二批：{realms}/users?first=1000&max=1000
• 后续批次依次累加first的值，直到返回结果为空或数量小于max。这种方式能大幅降低单次请求的数据负载，从根本上避免超时。

优化请求处理逻辑 #

如果用Python Requests库，除了设置合理的超时时间（比如timeout=300，即5分钟），还可以开启流式响应来减少内存占用，避免因等待全量数据返回超时：

import requests

admin_token = "YOUR_ADMIN_ACCESS_TOKEN"
base_url = "https://your-keycloak-instance/auth/realms/your-realm/users"
headers = {"Authorization": f"Bearer {admin_token}"}
batch_size = 1000
current_offset = 0

while True:
    params = {"first": current_offset, "max": batch_size}
    resp = requests.get(base_url, headers=headers, params=params, timeout=300, stream=True)
    resp.raise_for_status()
    batch_users = resp.json()
    
    if not batch_users:
        break
    
    # 在这里处理当前批次的用户数据（比如写入文件/数据库）
    print(f"处理了 {len(batch_users)} 条用户数据")
    current_offset += batch_size

调整Keycloak服务器配置 #

如果分页仍出现超时，可以修改Keycloak的服务器配置文件（standalone.xml或standalone-ha.xml）：

• 找到http-listener节点，增大read-timeout和connection-timeout值（比如设为300000，即5分钟）
• 调整jboss.as.web.max-post-size参数，确保服务器能处理较大的响应数据

直接使用Keycloak导出工具 #

如果只是一次性导出用户数据，官方的导出工具比API更稳定，适合处理大量数据：

# 导出指定领域的用户到JSON文件
./bin/kc.sh export --realm your-realm --users realm_file --file users_export.json

内容的提问来源于stack exchange，提问作者Josué Venegas