Keycloak设置UPDATE_PASSWORD必填操作后登录报Bad Request，如何捕获响应提示？

当你创建的用户带有requiredActions: ["UPDATE_PASSWORD"]和临时密码时，登录接口返回的400 Bad Request响应体中会包含明确的错误信息和必填操作标识，以下是不同场景下的捕获方法：

后端代码捕获（以Java调用Keycloak API为例） #

• 捕获HTTP 400类型的异常，读取响应体的JSON内容
• 提取error_description字段获取提示文本，或requiredActions数组确认具体操作
  示例代码：

try {
    // 此处为发送登录请求的逻辑（如调用Keycloak的token接口）
} catch (HttpClientErrorException.BadRequest e) {
    String responseBody = e.getResponseBodyAsString();
    ObjectMapper mapper = new ObjectMapper();
    Map<String, Object> errorInfo = mapper.readValue(responseBody, Map.class);
    
    // 获取错误描述
    String promptMsg = (String) errorInfo.get("error_description");
    // 获取必填操作列表
    List<String> requiredActions = (List<String>) errorInfo.get("requiredActions");
    
    // 根据获取到的信息处理业务逻辑，比如返回提示给用户
}

前端请求捕获（以Axios为例） #

• 在请求的catch块中判断响应状态为400，读取响应体数据
• 直接提取对应的错误字段展示给用户
  示例代码：

axios.post('/realms/{你的Realm名}/protocol/openid-connect/token', 
  new URLSearchParams({
    username: 'user',
    password: '123',
    grant_type: 'password',
    client_id: '你的客户端ID'
  })
)
.then(res => {
  // 登录成功后的处理逻辑
})
.catch(err => {
  if (err.response?.status === 400) {
    const errorData = err.response.data;
    // 提取提示信息
    const tip = errorData.error_description; // 示例值："User is required to update password."
    // 提取必填操作
    const actions = errorData.requiredActions; // 示例值：["UPDATE_PASSWORD"]
    
    // 将提示信息展示给用户，比如弹出提示框
    alert(tip || '请完成密码更新操作后再登录');
  }
});

核心逻辑：无论前后端，都是捕获400响应并解析响应体的JSON数据，Keycloak会在响应中明确返回错误描述和必填操作列表，直接提取这些字段即可得到你需要的提示内容。

内容的提问来源于stack exchange，提问作者Hồ Kim Long Sơn