Keycloak无必填用户操作仍提示“账户未完全设置”问题解决

问题场景 #

执行以下curl命令通过password授权类型获取Keycloak令牌：

curl -X POST http://localhost:8180/realms/myrealm/protocol/openid-connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "username=karim" \
  -d "password=azerty" \
  -d "grant_type=password" \
  -d "client_id=user-backend"

返回错误：

{"error":"invalid_grant","error_description":"Account is not fully set up"}

已确认用户满足以下条件：

• 用户状态为启用
• 邮箱已完成验证
• 无待处理的必填用户操作

解决方法 #

登录Keycloak管理控制台，找到对应用户，在用户资料中补充填写名字和姓氏字段，保存后重新请求令牌即可解决该错误。

原因：Keycloak会默认将名字、姓氏为空的账户判定为未完全设置，即使其他核心条件都已满足。

内容的提问来源于stack exchange，提问作者karim AIT BOUADDI