Keycloak：无法搜索系统生成的服务账户用户

环境信息 #

• Keycloak版本：20.0.3
• Docker启动命令：

  docker run --name keycloak -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:22.0.1 start-dev
  

问题现象 #

按以下操作后出现搜索异常：

1. 登录Keycloak后台
2. 创建新Realm
3. 在Clients中创建名为system_user_demo_service的客户端，配置：
   • client authentication: On
   • Authorization: On
   • Authentication flow: Standard Flow, Direct access grants
4. 进入Users页面可见自动生成的用户service-account-system_user_demo_service，但搜索该用户名时提示「未找到搜索结果」

解决步骤 #

Keycloak默认用户搜索范围不包含服务账户类型的用户，调整筛选规则即可解决：

• 进入Users页面，点击右上角的View all users（或页面中的筛选按钮）
• 在筛选面板中勾选Service accounts选项
• 点击Apply保存筛选，此时再搜索目标用户名就能正常显示结果

内容的提问来源于stack exchange，提问作者Sk Monjurul Haque