适用版本： 6.8-8.x
1. 错误说明 #
报错 failed to parse application privileges for role [<role>]. expected field [<field>] value to be an array of objects; but found an array element of type [<token>] 表示角色定义中的某个应用权限字段虽然是数组，但数组里的元素类型不对。
Elasticsearch 期望该数组的每个元素都是对象，例如包含 application、resources、privileges 的 JSON 对象。如果数组中混入字符串、数字、布尔值或其他非对象元素，就会触发这个异常。
2. 常见触发场景 #
- 把
applications写成字符串数组，而不是对象数组。 - 配置系统把单个对象错误展开成字符串列表。
- 手工编辑角色 JSON 时误删了对象花括号。
错误示例：
{
"applications": [
"kibana_read"
]
}
3. 排查方法 #
- 查看报错中提到的字段名，确认该字段的值是不是数组。
- 检查数组中的每个元素类型，确认是否都以
{}对象形式定义。 - 如果请求体来自程序序列化，打印最终发送给 Elasticsearch 的 JSON，避免只检查业务对象而忽略序列化结果。
4. 修复方法 #
- 将数组元素改为对象结构。
- 每个元素中显式提供
application、resources、privileges等字段。
修正示例：
{
"applications": [
{
"application": "kibana-.kibana",
"resources": ["space:default"],
"privileges": ["read"]
}
]
}
5. 预防建议 #
- 为角色配置生成逻辑增加类型断言，确保数组元素始终是对象。
- 如果配置来自 YAML 或表单，增加转换后的 JSON 快照校验。
- 对权限配置做接口级回归测试，覆盖单元素、多元素和空数组场景。
相关错误 #
附：日志上下文 #
private static ApplicationResourcePrivileges parseApplicationPrivilege(String roleName, XContentParser parser) throws IOException {
XContentParser.Token token = parser.currentToken();
if (token != XContentParser.Token.START_OBJECT) {
throw new ElasticsearchParseException(
"failed to parse application privileges for role [{}]. expected field [{}] value to "
+ "be an array of objects; but found an array element of type [{}]",
roleName,
parser.currentName(),
token
);
}
