Keycloak调用Admin API分配客户端角色时报404角色不存在如何解决

• 端点路径匹配校验
  你参考的官方端点POST /{realm}/groups/{id}/role-mappings/clients/{client}是群组角色映射接口，实际你给用户加角色调用的是用户角色映射接口，需要确认实际请求路径前缀是/{realm}/users/{用户UUID}/role-mappings/clients/，没有混用群组/用户的接口路径。
• 路径客户端参数校验
  路径末尾的{client}参数必须填写角色所属客户端的UUID，不可填写客户端的可读标识clientId（比如控制台配置的test-app这类业务标识）。请确认你路径中的3f222762-5300-48f2-be48-32f001d5a7dc是test_role_app所属客户端的真实UUID。
• 角色归属校验
  请求体中填写的角色ID32f02358-9312-4b7b-8584-85dcaf257667必须属于路径中指定的客户端，如果该角色是领域级角色、或者归属于其他客户端，就会触发角色不存在的报错。
• 权限校验
  调用接口使用的管理员访问令牌，需要拥有对应客户端的角色映射权限、以及操作用户的修改权限，部分Keycloak版本会对无权限访问的资源返回404错误，避免泄露资源存在性。
• 领域归属校验
  确认路径中的testrealm是用户、客户端、角色共同所属的领域，不存在跨领域调用的情况。

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