适用版本： 6.8-8.x
1. 错误说明 #
报错 failed to parse indices privileges for role [<role>]. missing required [<field>] field 表示单个索引权限对象里缺少 Elasticsearch 解析所必需的字段。
从附录可以看到，解析器至少会检查 names 和 privileges 是否成功读取。任意一个为空，都会直接报错。
2. 常见触发场景 #
- 写了
indices权限对象，但只配置了names，没有配置privileges。 - 模板里条件分支把
names或privileges整个跳过了。 - 迁移旧角色配置时字段名写错，导致解析器没有读到必填字段。
错误示例：
{
"indices": [
{
"names": ["logs-*"]
}
]
}
3. 排查方法 #
- 查看异常里缺失的是哪个字段。
- 打开最终请求体，确认该字段是完全缺失，还是写在错误层级。
- 如果请求由模板生成，检查条件判断是否在某些场景下删除了必填字段。
- 核对字段名拼写，避免把
privileges写成非标准名称。
4. 修复方法 #
- 为每个索引权限对象补齐
names和privileges。 - 确保这些字段位于同一个权限对象内部，而不是写到上层或其他对象中。
修正示例：
{
"indices": [
{
"names": ["logs-*"],
"privileges": ["read"]
}
]
}
5. 预防建议 #
- 对角色定义建立必填字段清单，并在提交前自动校验。
- 对模板生成结果做结构化断言，而不是只看字符串是否非空。
- 使用官方 API 示例作为基线，减少字段漏写和层级错误。
相关错误 #
附：日志上下文 #
throw new ElasticsearchParseException("failed to parse indices privileges for role [{}]. unexpected field [{}]";
roleName; currentFieldName);
}
}
if (names == null) {
throw new ElasticsearchParseException("failed to parse indices privileges for role [{}]. missing required [{}] field";
roleName; Fields.NAMES.getPreferredName());
}
if (privileges == null) {
throw new ElasticsearchParseException("failed to parse indices privileges for role [{}]. missing required [{}] field";
roleName; Fields.PRIVILEGES.getPreferredName());
