Keycloak管理控制台始终返回401未授权，无法登录求助

方法一：使用Keycloak命令行工具（kcadm）修复配置 #

• 进入Keycloak安装目录的bin文件夹
• 配置管理员凭据连接到服务器（替换your-admin-password为原管理员密码）：

  ./kcadm.sh config credentials --server https://mykeycloak.com --realm master --user admin --password your-admin-password
  

  若忘记管理员密码，先执行方法二重置密码。
• 查询admin-cli客户端的ID（管理控制台依赖此客户端完成认证）：

  ./kcadm.sh get clients -r master --query clientId=admin-cli
  

  从返回结果中复制id字段的值，替换后续命令中的<client-id>
• 重置admin-cli客户端的关键配置，确保认证流程正常：

  ./kcadm.sh update clients/<client-id> -r master -s "publicClient=false" -s "directAccessGrantsEnabled=true" -s "serviceAccountsEnabled=true"
  

• 验证管理员角色权限，确保admin用户拥有master realm的管理员角色：

  ./kcadm.sh add-roles --uusername admin --rolename admin --rname master
  

方法二：重置管理员账号密码 #

若无法通过原管理员账号连接，先重置密码：

• 停止当前Keycloak服务
• 启动服务时添加重置管理员参数（生产环境替换start-dev为start，需符合部署要求）：

  ./kc.sh start-dev --admin-user new-admin --admin-password new-admin-password
  

• 启动完成后，用新管理员账号登录管理控制台，再检查并修正服务账户相关配置

方法三：直接修改数据库（谨慎操作） #

若上述方法无效，可尝试修改数据库表（操作前务必备份数据库）：

• 找到Keycloak对应的数据库，定位client表
• 查询client_id为admin-cli的记录，修改以下字段值：
  • direct_access_grants_enabled = true
  • public_client = false
  • service_accounts_enabled = true
• 找到user_role_mapping表，确保admin用户（user_id对应管理员用户ID）关联master realm的admin角色（role_id对应管理员角色ID）
• 重启Keycloak服务

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