privileges check 解析失败：应为对象却收到其他类型 - 如何解决此 Elasticsearch 异常

适用版本： 6.8-7.15

1. 错误异常的基本描述 #

在执行权限检查时，如果请求体顶层不是一个 JSON 对象，Elasticsearch 会报：

failed to parse privileges check [description]. expected an object but found [TOKEN] instead

2. 为什么会发生这个错误 #

这不是鉴权失败，而是请求 JSON 结构错误。源码在解析 privileges check 时，第一步就要求读取到 START_OBJECT；如果不是，直接抛出 ElasticsearchParseException。

也就是说，问题出在请求体形状，而不是用户权限本身。

3. 如何排查和解决这个异常 #

1. 打印最终请求体，确认顶层是不是对象。
2. 检查是否把数组、字符串或 null 错传到了 privileges check 接口。
3. 如果请求由 SDK 组装，确认序列化结果没有丢掉最外层对象。

4. 如何解决这个错误 #

方案一：把请求体改成合法对象 #

确保最外层是 JSON object，而不是值或数组。

方案二：检查调用封装 #

如果使用了中间层封装，确认没有把 body 错误包装成字符串或列表。

方案三：从最小示例重建请求 #

先用最小合法 privileges check 请求验证，再逐步补其他字段。

5. 预防建议 #

• 对安全接口请求做 schema 校验。
• 保留最终发往 Elasticsearch 的原始 JSON。
• 不要依赖松散的 map/string 拼装安全请求。

6. 小结 #

expected an object but found instead 说明 privileges check 请求的最外层结构就错了。修复关键是恢复正确 JSON 形状，而不是去排查账号、角色或 TLS 配置。

相关错误 #

• failed-to-parse-privileges-check-unexpected-field-how-to-solve-this-elasticsearch-exception
• failed-to-parse-field-query-from-the-role-descriptor-how-to-solve-this-elasticsearch-exception
• failed-to-parse-object-expected-start-object-but-was-how-to-solve-this-elasticsearch-exception

附：日志上下文 #

    XContentParser parser = xContentType.xContent()
    .createParser(NamedXContentRegistry.EMPTY; LoggingDeprecationHandler.INSTANCE; stream)) {
    // advance to the START_OBJECT token
    XContentParser.Token token = parser.nextToken();
    if (token != XContentParser.Token.START_OBJECT) {
        throw new ElasticsearchParseException("failed to parse privileges check [{}]. expected an object but found [{}] instead";
        description; token);
    }
    String currentFieldName = null;
    IndicesPrivileges[] indexPrivileges = null;
    String[] clusterPrivileges = null;