Keycloak手动发送邮箱验证邮件API报错400问题求助

数据老陈

2026-6-16

解决Keycloak /{realm}/users/{id}/execute-actions-email接口指定actions报错问题

修正请求体格式：该接口要求请求体为数组格式的action列表，而非字符串或对象。正确的请求体示例：
```
["VERIFY_EMAIL"]
```
若写成"VERIFY_EMAIL"或其他非数组格式，会直接返回400错误。
检查请求头与权限：
- 必须设置请求头Content-Type: application/json，否则Keycloak无法正确解析请求体。
- 确保使用的Admin Token包含manage-users或impersonation权限，且Token所属realm与目标realm一致，权限不匹配或跨realm请求可能被误返回400错误（部分版本会混淆权限错误为格式错误）。
匹配Keycloak版本的枚举值：
- 多数版本使用VERIFY_EMAIL作为邮箱验证的action值，若使用旧版本可通过Admin Console用户操作页面抓包，确认官方请求的action参数值，直接复用即可避免版本兼容问题。