如何在Elasticsearch中实现基于文档的精确匹配？

要满足这种“文档内容是搜索文本子串”的匹配逻辑，需要从映射优化和查询语句两方面入手：

1. 更新索引映射 #

首先给name字段添加两个子字段，分别用于存储原始完整值和小写化后的内容，避免分词干扰并支持大小写不敏感匹配：

PUT /indexName/_mapping
{
  "properties": {
    "name": {
      "type": "text",
      "fields": {
        "raw": {
          "type": "keyword"
        },
        "lowercase": {
          "type": "text",
          "analyzer": "lowercase"
        }
      }
    }
  }
}

• name.raw：保存字段的原始完整值，用于后续精确匹配；
• name.lowercase：通过lowercase分词器统一转为小写，实现大小写不敏感的子串判断。

2. 编写查询语句 #

核心逻辑是：将搜索文本转为小写后，检查每个文档的name.lowercase值是否是它的子串。使用bool过滤器结合脚本查询实现：

通用查询模板 #

POST /indexName/_search
{
  "query": {
    "bool": {
      "filter": [
        {
          "script": {
            "script": {
              "source": """
                String searchText = params.searchText.toLowerCase();
                String docValue = doc['name.lowercase'].value;
                return searchText.contains(docValue);
              """,
              "params": {
                "searchText": "替换为你的搜索内容"
              }
            }
          }
        }
      ]
    }
  }
}

各场景验证 #

• 搜索"City"：搜索文本转小写为city，第一个文档的name.lowercase是city（被包含），第二个是city lab（不被city包含），仅返回第一个文档；
• 搜索"City Lab"：搜索文本转小写为city lab，同时包含city和city lab，两个文档都匹配；
• 搜索"where is the City Lab"：搜索文本转小写后包含city和city lab，两个文档都返回；
• 搜索"lab"：搜索文本转小写为lab，没有文档的name.lowercase值是lab，返回0条；
• 搜索"I am inside the city, then I will go to the lab"：搜索文本转小写后包含city，但不包含连续的city lab，仅返回第一个文档。

性能提示 #

如果索引数据量较大，脚本查询的性能可能会有所下降。可以考虑在索引时预计算字段的小写值，或者结合ngram分词器优化，但脚本查询是最直接贴合需求的实现方式。另外要确保Elasticsearch允许脚本查询（默认开启，若有配置修改需检查script.allowed_types参数）。

内容的提问来源于stack exchange，提问作者Hamza AlAjlouni