Elasticsearch映射解析报错时，如何定位接收空字符串的字段？

这个问题我之前也碰到过，Elasticsearch默认返回的错误信息确实不会直接点明是哪个字段出了问题，不过有几个实用的方法能帮你精准定位：

1. 开启映射解析的DEBUG日志 #

Elasticsearch的默认日志级别不会输出字段级的解析细节，你可以修改elasticsearch.yml配置文件，把映射相关的日志级别调到DEBUG：

logger.org.elasticsearch.index.mapper: DEBUG

保存配置后重启Elasticsearch，之后再出现解析错误时，日志里会清晰打印出具体的字段路径和错误详情，比如：

Failed to parse field [price] of type [double] in document with id '776896'. Preview of field's value: ''

这种方法不需要修改业务代码，是最直接的全局排查方式。

2. 使用Validate API快速验证单文档 #

如果你只是想排查某一个出错的文档，可以用Elasticsearch的_validate/document API来单独检查文档是否符合映射规则。比如在Kibana Dev Tools或者curl里执行：

POST /product-staging-2-products/_validate/document?pretty
{
  "doc": {
    // 这里粘贴你要检查的product文档内容
  }
}

如果文档有问题，返回结果里会明确指出出错的字段，类似这样：

"reason" : "failed to parse field [stock_count] of type [integer] in document with id 'null'. Preview of field's value: ''"

3. 用Ingest Pipeline做字段级错误捕获（适合批量导入场景） #

如果是批量导入数据的场景，你可以创建一个Ingest Pipeline，在数据写入前对数字字段做转换验证，并在失败时记录具体的字段信息：

PUT _ingest/pipeline/validate-numeric-fields
{
  "description": "验证数字字段并记录错误详情",
  "processors": [
    {
      "convert": {
        "field": "price",
        "type": "double",
        "on_failure": [
          {
            "set": {
              "field": "_ingest.error_details",
              "value": "字段[price]转换失败，值为: {{_source.price}}"
            }
          }
        ]
      }
    },
    {
      "convert": {
        "field": "stock_count",
        "type": "integer",
        "on_failure": [
          {
            "set": {
              "field": "_ingest.error_details",
              "value": "字段[stock_count]转换失败，值为: {{_source.stock_count}}"
            }
          }
        ]
      }
    }
    // 对所有数字字段重复上述convert处理器配置
  ]
}

之后导入数据时指定这个pipeline：

PUT /product-staging-2-products/_doc/776896?pipeline=validate-numeric-fields

如果转换失败，返回的错误信息里会包含我们自定义的_ingest.error_details字段，直接告诉你是哪个字段出了问题。

4. 业务代码里提前做字段校验 #

如果你的数据是通过自定义程序写入Elasticsearch的，也可以在代码层面对数字类型字段做前置检查：当字段值为空字符串时，直接打印日志记录字段名和文档ID，从源头避免错误写入的同时，也能快速定位问题。

内容的提问来源于stack exchange，提问作者Tiancheng Liu