Keycloak 16.0是否支持用户列表分页、过滤及自定义属性排序？

你没有遗漏任何接口配置或隐藏能力，Keycloak 16.0 版本原生的管理端用户查询接口确实未提供排序功能，返回结果硬编码默认按用户名字段升序排列，没有开放可配置的排序开关或参数。

根据你的项目用户规模和改造成本接受度，可以选以下三种实现方案：

• 小用户量场景：内存排序二次分页
  如果你的单个Realm下总用户量在万级以内，这是实现成本最低的方案：

  1. 先调整Keycloak配置，放开默认单页最大100条的返回限制（修改配置文件中maxResultsLimit参数即可）
  2. 后端调用Keycloak接口时拉取所有符合过滤条件的用户数据
  3. 在Spring Boot服务内存中按前端传入的排序字段（邮箱/用户名/姓名等）、排序方向做排序，再根据分页参数截取对应页数据返回给Angular前端
     这个方案不需要修改Keycloak核心逻辑，开发量极小，缺点是用户量超过10万级后接口响应延迟会明显升高，不适合超大规模用户场景。

• 生产级大用户量场景：自定义Keycloak SPI扩展
  如果用户量较大，推荐通过Keycloak的SPI机制扩展原生接口能力：

  1. 基于Keycloak 16.0的源码，扩展默认的用户查询Provider，给原有getUsers接口新增两个自定义查询参数：sortBy（指定排序字段，支持username、email、firstName、lastName等常用属性）、sortOrder（指定升序/降序，可选值asc/desc）
  2. 改写底层JPA查询逻辑，根据传入的排序参数动态拼接ORDER BY子句，保留原有所有过滤、分页参数的逻辑不变
  3. 将扩展打包为jar包放入Keycloak的providers目录，重启服务加载扩展后即可使用
     这个方案性能最好，和原生接口兼容性最高，缺点是需要维护自定义的Keycloak扩展，后续升级Keycloak版本需要适配对应版本的SPI接口。

• 轻量改造方案：直接只读查询Keycloak数据库
  如果不想修改Keycloak本身，可以在Spring Boot服务中额外配置一个指向Keycloak数据库的只读数据源：

  1. Keycloak所有用户基础属性都存储在user_entity表中，相关字段均建有索引
  2. 直接通过SQL实现过滤条件、动态排序、分页逻辑，返回结果给前端
     注意这种方案只能做只读查询，绝对不要直接写入Keycloak业务表，避免数据一致性问题，同时要做好版本适配，防止Keycloak升级后表结构变动引发故障。

网上有说法称q参数可以实现排序，这个说法是错误的：q参数仅用于自定义用户属性的键值对搜索，不具备排序能力。Keycloak官方是在22及之后的版本才在原生用户查询接口中正式加入排序参数，16.0版本无原生支持。

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