读取 indices options 时出现未预期的对象字段 - 如何解决此 Elasticsearch 异常

适用版本： 7.x-8.x

1. 问题含义 #

could not read indices options. unexpected object field [field] 表示 Elasticsearch 在读取 indices_options 时，发现某个字段的值是对象结构，但当前解析器只接受布尔值、字符串或特定简化结构，不接受嵌套对象。

这类异常经常发生在调用方试图把复杂配置塞进 indices_options，或者误把别的 API 参数复制进来。

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

附带源码显示，当 token 落入对象分支但字段又不应为对象时，解析器会直接抛出该异常。

常见错误场景：

• 把 indices_options 写成层层嵌套对象。
• 将 expand_wildcards 等字段包装成 { "value": ... }。
• 中间层序列化时额外包了一层对象。

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

1. 找到报错中的字段名 [field]。
2. 查看最终 JSON，确认该字段是否被写成对象。
3. 对照文档确认它应当是布尔值、字符串还是数组。
4. 去掉多余对象包装，改成 Elasticsearch 支持的平面结构。
5. 重新测试并检查是否还存在非法选项名问题。

错误示例 #

{
  "indices_options": {
    "ignore_unavailable": {
      "value": true
    }
  }
}

正确示例 #

{
  "indices_options": {
    "ignore_unavailable": true,
    "allow_no_indices": true
  }
}

4. 修复建议 #

• 保持 indices_options 扁平化，不要自行包装对象。
• 检查序列化器是否自动输出了 value、enabled 等中间层。
• 为请求对象增加 schema 校验，禁止嵌套对象进入该字段。

5. 小结 #

unexpected object field [field] 说明 indices_options 的结构写复杂了。这个字段通常应保持扁平，去掉对象包装后问题就会消失。

相关错误 #

• could-not-read-indices-options-unexpected-index-option-how-to-solve-this-elasticsearch-exception
• could-not-read-indices-options-unexpected-object-field-currentfieldname-how-to-solve-this-elasticsearch-exception
• parse-exception-how-to-solve-this-elasticsearch-exception

附：日志上下文 #

    } else {
        throw new ElasticsearchParseException("could not read indices options. unexpected index option [" +
            currentFieldName + "]");
    }
} else {
    throw new ElasticsearchParseException("could not read indices options. unexpected object field [" +
        currentFieldName + "]");
}
}
if (wildcardStates == null) {