Elasticsearch：如何定位模糊搜索匹配的数组元素？

默认情况下，Elasticsearch会将对象数组扁平化存储，这意味着names数组里的userName和nameType字段会被拆分成独立的字段集合，无法直接关联到原始的数组元素。要精准定位到匹配的别名，你需要先将names字段设置为nested类型，再配合inner_hits或高亮功能获取匹配的具体元素。

步骤1：修改索引映射为nested类型 #

首先需要更新你的索引映射，把names定义为nested类型（如果是新建索引直接配置即可，已有数据需要重新索引）：

{
  "mappings": {
    "properties": {
      "names": {
        "type": "nested",
        "properties": {
          "userName": {
            "type": "text"
          },
          "nameType": {
            "type": "keyword"
          }
        }
      }
    }
  }
}

步骤2：使用nested查询+inner_hits获取匹配的别名 #

调整你的查询，用nested查询包裹原有的span_near逻辑，并添加inner_hits配置，ES会直接返回触发匹配的具体别名对象：

{
  "query": {
    "nested": {
      "path": "names",
      "query": {
        "span_near": {
          "clauses": [
            {
              "span_multi": {
                "match": {
                  "fuzzy": {
                    "names.userName": {
                      "value": "jone",
                      "fuzziness": "1",
                      "prefix_length": 0,
                      "max_expansions": 50,
                      "transpositions": true,
                      "boost": 1
                    }
                  }
                },
                "boost": 1
              }
            },
            {
              "span_multi": {
                "match": {
                  "fuzzy": {
                    "names.userName": {
                      "value": "great",
                      "fuzziness": "1",
                      "prefix_length": 0,
                      "max_expansions": 50,
                      "transpositions": true,
                      "boost": 1
                    }
                  }
                },
                "boost": 1
              }
            }
          ],
          "slop": 2,
          "in_order": false,
          "boost": 1
        }
      },
      "inner_hits": {
        "_source": ["names.userName", "names.nameType"],
        "size": 10  // 最多返回10个匹配的别名，按需调整
      }
    }
  }
}

返回结果的inner_hits部分会列出所有触发匹配的names对象，无需再遍历整个数组手动筛选。

步骤3：配合高亮功能标记匹配文本 #

如果需要直观看到匹配的文本片段，可以在inner_hits中添加高亮配置：

{
  "query": {
    "nested": {
      "path": "names",
      "query": {
        "span_near": {
          // 保留原有span_near查询逻辑
        }
      },
      "inner_hits": {
        "_source": ["names.userName", "names.nameType"],
        "highlight": {
          "fields": {
            "names.userName": {}
          }
        }
      }
    }
  }
}

返回的inner_hits.highlight会用<em>标签标记匹配的文本部分，方便快速识别关键匹配内容。

关键说明 #

• 使用nested类型后，每个names数组元素会被作为独立的子文档存储，查询时可以精准关联到匹配的子元素，避免了扁平化存储导致的关联丢失问题。
• inner_hits直接返回匹配的子文档，性能远优于客户端遍历筛选，尤其适合数组元素较多的场景。

内容的提问来源于stack exchange，提问作者Phi Tran