适用版本： 6.8-8.x
1. 错误说明 #
报错 failed to parse application privileges for role [<role>]. missing required [<field>] field 表示 Elasticsearch 在解析角色中的 applications 权限配置时，发现某个应用权限对象缺少必填字段。
从日志上下文看，至少 resources 和 privileges 是强制要求的字段。只要其中任意一个缺失，角色定义就无法通过解析。
2. 常见触发场景 #
- 在
applications数组里只写了application，漏掉resources或privileges。 - 通过模板渲染角色 JSON 时，空值字段被过滤掉，导致必填字段最终未输出。
- 将一条应用权限拆分或合并时，误把字段名写错，例如写成
resource或permission。
错误示例：
{
"applications": [
{
"application": "kibana-.kibana"
}
]
}
3. 排查方法 #
- 检查角色请求体中的
applications数组，确认每个对象都包含application、resources、privileges。 - 如果角色定义由脚本、Terraform、Ansible 或内部平台生成，查看生成后的最终 JSON，而不是只看模板源文件。
- 在服务端日志中确认缺失的是哪个字段，再反查对应的生成逻辑或配置来源。
4. 修复方法 #
- 为每个应用权限对象补齐必需字段。
- 确保
resources和privileges都是非空数组，而不是省略、null或错误的字段名。
修正示例：
{
"applications": [
{
"application": "kibana-.kibana",
"resources": ["space:default"],
"privileges": ["read"]
}
]
}
5. 预防建议 #
- 对角色定义增加 JSON Schema 或请求前校验，提前检查必填字段是否齐全。
- 生成角色配置时保留空值审计日志，避免模板在渲染时静默丢字段。
- 将角色 API 的回放测试纳入发布流程，防止权限模型调整后引入结构缺失问题。
相关错误 #
附：日志上下文 #
final ApplicationResourcePrivileges.Builder builder = ApplicationResourcePrivileges.PARSER.parse(parser, null);
if (builder.hasResources() == false) {
throw new ElasticsearchParseException(
"failed to parse application privileges for role [{}]. missing required [{}] field",
roleName,
Fields.RESOURCES.getPreferredName()
);
}
if (builder.hasPrivileges() == false) {
throw new ElasticsearchParseException(
"failed to parse application privileges for role [{}]. missing required [{}] field",
roleName,
Fields.PRIVILEGES.getPreferredName()
);
}
