常见报错

写入Elasticsearch异常：HTTP/1.1 413 Request Entity Too Large

报错原因

Elasticsearch中设置内容的最大容量参数为http.max_content_length，该参数的默认值是100 MB，而且不建议修改，当写入的数据量超过了此值就会报错。

解决方案

调整写入数据量，每次写入请求的数据量=文档数量*单个文档的大小。仅凭文档数量可能无法准确评估写入数据量的大小，它取决于您每个文档的大小及复杂性。如果您的单个文档数据量很大，可以适当减少文档数量。一般建议每次写入请求的数据量从5 MB~15 MB开始调试，默认不能超过100 MB（详细信息请参见HTTP settings）。具体调试方案，请参见官方使用和调试批量请求文档。

Elasticsearch写数据时报错：forbids automatic creation of the index

报错原因

阿里云Elasticsearch实例未开启自动创建索引功能。

解决方案

在Elasticsearch控制台的集群配置页面，静态开启自动创建索引功能，您也可以通过命令方式开启，具体操作请参见配置YML参数。

主日志报错：all shards failed

报错说明

报错原因

解决方案

结合监控和日志判断集群状态是否健康。例如磁盘空间是否充足、索引和集群settings是否有设置一些参数导致无法分片等。如果出现节点失联或者无法分配分片的情况，需要先解决这些问题，具体操作如下：

1. 登录Kibana控制台。

2. 查看未分配的分片。

   GET /_cluster/allocation/explain

   说明

   如果集群中没有未分配的分片，则返回error。

3. 重新分配失败的分片。

   POST /_cluster/reroute?retry_failed=true

主日志中出现SSL/TSL相关报错如何处理？

报错原因

解决方案

更多SSL/TSL的相关问题，请参见Common SSL/TLS exceptions。

xpack-sql查询报错：No keyword/multi-field defined exact matches for [KeywordField]

报错原因

xpack-sql的LIKE操作使用了text类型的字段。

解决方案

xpack-sql的LIKE操作仅支持对keyword类型的字段做精确过滤，不支持text字段类型，请将字段类型改成keyword类型，详情请参见Unable to run SQL query on multi fields using Elastic Search v. 7.3和SQL and multi-fields。

数据备份，执行PUT _snapshot/my_backup报错：path is not accessiable on master node

报错原因

在进行数据备份时，使用的OSS Bucket是归档存储类型的，读文件前需要解冻，导致了该报错。

解决方案

目前阿里云Elasticsearch不支持将数据备份至归档存储类型的OSS Bucket中，请使用标准存储类型的Bucket，且Bucket的地域与Elasticsearch实例的地域保持一致，详细信息请参见手动备份与恢复。

进入Kibana时报错：kibana did not load properly

报错原因

当Elasticsearch集群各数据节点磁盘使用率超过95%后，会触发Elasticsearch自动保护机制，自动保护机制会对Elasticsearch集群中的每个索引强制设置read_only_allow_delete属性，此时索引将无法写入数据，只能读取和删除对应索引。

解决方案

1. 参见集群磁盘使用率过高和read_only问题的排查与处理方法，修复磁盘使用率过高的问题。

2. 执行以下命令，将集群中所有索引的index.blocks.read_only_allow_delete属性设置为null，使集群中不再存在read_only状态的索引。

   PUT _settings
   {  
      "index.blocks.read_only_allow_delete": null
   }

使用aliyun-qos插件报错：unsupported_operation_execption

报错说明

{
   "error": {
      "root_cause": [
            {
               "type": "unsupported_operation_exception",
               "reason": "unsupported_operation_exception: only define search or bulk action for limit"
            }
         ],
         "type": "unsupported_operation_exception",
         "reason": "unsupported_operation_exception: only define search or bulk action for limit"
      },
   "status": 500
}

报错原因

插件没有升级至最新版本。

解决方案

使用Transport访问Elasticsearch的9300端口，报错：NoNodeAvailableException

报错说明

使用Transport方式访问阿里云Elasticsearch的9300端口，偶尔会出现NoNodeAvailableException[None of the configured nodes are available: [{#transport#-1}{HVdK7Cff****\_P0c9n****}{es-cn-v1qqweee****.elasticsearch.aliyuncs.com}{172.17.XX.XX:9300}]]，但是用户并没有172.17.XX.XX这个节点。

解决方案

这个是虚拟IP，一般用于负载均衡，不会影响业务，无需关注。详情请参见Elasticsearch兼容Transport Client的方法。

7.4版本主日志报错：Unclosed object or array found或ArrayIndexOutOfBoundsException

报错原因

此报错是开源Elasticsearch 7.4版本的bug导致的，不会影响业务的进行。

解决方案

此问题已经在高版本中解决，阿里云Elasticsearch的7.4版本也已经停止售卖。如果出现此类问题，建议您退订后重新按需购买高版本的集群。退订前如果需要迁移您当前实例上的数据，请参见迁移方案选取指南选择对应的迁移方案，确保您实例上现有的数据不会丢失。

使用aliyun-knn插件的余弦向量报错：No field found for [metaData] in mapping with types

使用ES的API密钥进行认证时报错：API keys not enabled in Elasticsearch