适用版本： 7.x-8.x
1. 问题含义 #
could not read indices options. unexpected index option [field] 表示 Elasticsearch 正在解析 indices_options 时，遇到了一个不在允许列表内的选项名。
从附带源码可以看出，解析器只接受少量固定字段，例如 ignore_unavailable、allow_no_indices、ignore_throttled 以及若干 expand_wildcards 相关项。其余字段名都会被视为非法选项。
2. 为什么会发生这个错误 #
常见原因包括：
- 手工拼写错误。
- 从旧版本或别的接口复制了不兼容的参数。
- 应用把业务字段误塞进
indices_options对象。
这类错误的关键不是值错，而是“选项名根本不被支持”。
3. 如何排查和解决这个异常和解决这个异常 #
- 从日志里提取非法选项名
[field]。 - 对照当前版本文档确认
indices_options支持哪些字段。 - 删除多余字段，或改成合法字段名。
- 如果这是版本升级引入的问题，检查客户端是否仍在发送旧参数。
- 用最小
indices_options结构重新验证。
错误示例 #
{
"indices_options": {
"ignore_unavailable": true,
"skip_closed": true
}
}
正确示例 #
{
"indices_options": {
"ignore_unavailable": true,
"allow_no_indices": true,
"ignore_throttled": false
}
}
4. 修复建议 #
- 把
indices_options的字段集合固定为白名单。 - 升级客户端或集群版本后，回归检查兼容性。
- 不要在
indices_options内混入业务控制字段。
5. 小结 #
unexpected index option [field] 表示问题出在选项名本身。只要把 indices_options 限制在 Elasticsearch 支持的字段集合内，通常就能直接修复。
相关错误 #
- could-not-read-indices-options-unexpected-object-field-how-to-solve-this-elasticsearch-exception
- could-not-read-indices-options-unexpected-object-field-currentfieldname-how-to-solve-this-elasticsearch-exception
- request-does-not-support-parser-currentname-how-to-solve-this-elasticsearch-exception
附：日志上下文 #
} else if (ALLOW_NO_INDICES_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
allowNoIndices = parser.booleanValue();
} else if (IGNORE_THROTTLED_FIELD.match(currentFieldName, parser.getDeprecationHandler())) {
ignoreThrottled = parser.booleanValue();
} 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 + "]");
