Elasticsearch查询匹配异常咨询：本该匹配却返回0结果及多值字段查询无匹配问题

这问题我之前排查过类似的，核心原因出在Elasticsearch字段的分词配置和term查询的特性上，咱们一步步拆解：

问题根源 #

1. term查询的精确匹配特性 #

term查询是「精确匹配」——它不会对输入的查询词做任何分词、大小写转换处理，只会直接去倒排索引里找完全一致的词项。也就是说，你输入的查询词必须和Elasticsearch存储的词项完全一模一样（包括大小写、空格、特殊字符），才能匹配到结果。

2. Assignaturas字段的分词行为 #

看你的文档里，Assignaturas字段的值是"Matemáticas, Educación Artística, Ciencias Sociales y Lengua Castellana"。如果这个字段用了Elasticsearch默认的分词配置（standard分词器+小写过滤器），它会被拆分成多个小写的独立词项，比如：
matemáticas、educación、artística、ciencias、sociales、y、lengua、castellana

这就解释了你的现象：

• 用小写的matemáticas查询时，刚好和倒排索引里的词项完全一致，所以能匹配到；
• 用大写的Matemáticas时，倒排索引里存的是小写的词项，精确匹配失败；
• 用Educación Artística查询时，倒排索引里没有这个完整的短语词项，只有拆分后的educación和artística，所以也匹配不到。

解决方案 #

根据你的需求场景，推荐以下几种方案：

方案一：匹配单个科目（不区分大小写）——改用match查询 #

如果你的需求是匹配包含某个科目的文档，不管大小写，直接把term查询换成match查询就行。match查询会对查询词做和字段一致的分词、大小写转换处理：

{"query": {"bool": {"filter": [
  {"term": {"Idioma": "castellano"}},
  {"match": {"Assignaturas": "Educación Artística"}},
  {"range": {"EdadMinima":{"gte":10}}},
  {"range": {"EdadMaxima":{"lte":11}}}
]}}}

这个查询会把Educación Artística分词成educación和artística，然后去倒排索引里匹配这两个词项，自然就能找到目标文档。

方案二：精确匹配整个字段内容——添加keyword子字段 #

如果你的需求是精确匹配整个Assignaturas字段的完整值（比如完整的科目列表），可以给字段添加一个keyword类型的子字段。先修改字段映射：

"Assignaturas": {
  "type": "text",
  "fields": {
    "keyword": {
      "type": "keyword",
      "ignore_above": 256
    }
  }
}

然后用term查询这个子字段：

{"query": {"bool": {"filter": [
  {"term": {"Idioma": "castellano"}},
  {"term": {"Assignaturas.keyword": "Matemáticas, Educación Artística, Ciencias Sociales y Lengua Castellana"}},
  {"range": {"EdadMinima":{"gte":10}}},
  {"range": {"EdadMaxima":{"lte":11}}}
]}}}

keyword类型的字段会完整存储原始值，不会做分词处理，所以能实现精确匹配。

方案三：用term查询单个科目且不区分大小写——配置normalizer #

如果一定要用term查询单个科目，同时希望不区分大小写，可以给字段配置小写归一化器。首先修改索引设置：

"settings": {
  "analysis": {
    "normalizer": {
      "lowercase_normalizer": {
        "type": "custom",
        "filter": ["lowercase"]
      }
    }
  }
}

然后修改字段映射，指定使用这个normalizer：

"Assignaturas": {
  "type": "text",
  "normalizer": "lowercase_normalizer"
}

这样不管文档里的科目是大写还是小写，都会被统一转换成小写存储到倒排索引里，之后用term查询时，不管输入大写还是小写的科目名，都能匹配到结果。

⚠️ 注意：修改映射或索引设置后，需要重新索引所有文档才能生效哦！

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