使用termQuery无结果，如何实现Elasticsearch精确匹配？

问题原因 #

你使用termQuery无结果的核心原因是目标字段的映射类型导致的：

• 如果external_reference是text类型，Elasticsearch默认会通过分词器将原始字符串拆分成多个词项存储，termQuery会精确匹配这些分词后的词项，而非原始完整字符串，因此匹配不到结果。
• matchQuery是基于分词的模糊匹配，所以会返回所有包含该值分词项的结果。

解决方案 #

方案1：使用字段的keyword子字段（推荐） #

多数情况下，创建text类型字段时，Elasticsearch会自动生成对应的keyword子字段（命名规则为字段名.keyword），该子字段存储原始完整字符串，适合精确匹配。

修改查询代码，直接用termQuery查询这个子字段：

val sourceBuilder = SearchSourceBuilder()
// 改用keyword子字段做精确匹配
sourceBuilder.query(QueryBuilders.termQuery("external_reference.keyword", id))

val searchRequest = SearchRequest()
searchRequest.indices(elasticIndex)
searchRequest.source(sourceBuilder)

val searchResponse = esClient.search(searchRequest, RequestOptions.DEFAULT)

方案2：修改字段映射为keyword类型 #

如果你的字段不需要分词、仅需精确匹配，可以直接将external_reference的类型改为keyword。注意：修改映射后需要重新索引现有数据才能生效。

映射修改示例（PUT请求）：

PUT /your_index/_mapping
{
  "properties": {
    "external_reference": {
      "type": "keyword"
    }
  }
}

修改后即可直接用termQuery查询原字段：

sourceBuilder.query(QueryBuilders.termQuery("external_reference", id))

方案3：使用match_phrase查询（备选） #

若无法修改映射，可使用matchPhraseQuery实现近似精确匹配（它会匹配连续的分词项序列，接近完整字符串匹配）：

sourceBuilder.query(QueryBuilders.matchPhraseQuery("external_reference", id))

这种方式适合字段必须保留text类型且需要完整短语匹配的场景，但可靠性不如keyword子字段的精确匹配。

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