Elasticsearch bool查询中must_not子句失效问题排查求助

我来帮你分析下为什么你的查询会返回包含stage: REJECTED的结果，常见原因和解决办法如下：

1. stage字段是text类型，导致term查询不匹配 #

这是最常见的问题。如果stage字段定义为text类型，Elasticsearch会默认用standard分词器处理它——比如把大写的REJECTED转换成小写的rejected存入索引。而term查询是精确匹配原始分词结果的，你用term查找"REJECTED"根本匹配不到存储为"rejected"的文档，自然must_not无法过滤掉这些数据。

解决办法： #

• 如果你只需要精确匹配，把stage字段改为keyword类型（需要重新索引数据）；
• 或者使用stage.keyword子字段查询（如果你的mapping已经设置了text+keyword多字段），修改后的must_not子句：

  "must_not": [
    { "term": { "stage.keyword": { "value": "REJECTED" } } }
  ]
  

• 也可以换成match查询（会自动分词匹配）：

  "must_not": [
    { "match": { "stage": "REJECTED" } }
  ]
  

2. filter子句无匹配结果，触发adjust_pure_negative的特殊行为 #

你设置了adjust_pure_negative: true，这个参数的作用是：当bool查询里的must/filter/should都没有匹配到任何文档时，会自动把查询转为match_all后再排除must_not的结果。如果你的partnerId: 12345没有匹配到任何文档，原本整个查询应该返回空，但这个参数会让ES忽略无结果的filter，直接执行must_not逻辑，导致你看到不符合预期的结果。

验证方法： #

单独执行filter的查询，确认是否有匹配的文档：

POST /test/_search
{
  "query": {
    "term": { "partnerId": { "value": 12345 } }
  }
}

如果这个查询返回空，建议去掉adjust_pure_negative: true（默认值就是false，不需要额外设置）。

3. stage字段是数组类型，存在多个值 #

如果某个文档的stage是数组（比如["APPROVED", "REJECTED"]），理论上term查询会匹配到该文档，must_not应该排除它。但可以验证下这类文档的实际存储值，确认是否存在逻辑偏差：

POST /test/_search
{
  "query": {
    "bool": {
      "filter": [{ "term": { "partnerId": 12345 } }],
      "must": [{ "term": { "stage": "REJECTED" } }]
    }
  },
  "_source": ["stage", "partnerId"]
}

查看返回文档中stage的具体值，确认是否和预期一致。

4. 大小写或拼写不一致 #

检查返回文档中stage字段的实际值，是不是和你查询的"REJECTED"有大小写差异（比如"rejected"、"Rejected"），或者拼写错误（比如"REJECTEDD"）。如果是keyword类型的字段，term查询是大小写敏感的，这种情况下查询条件和实际值不匹配，must_not就无法过滤。

解决办法： #

如果需要大小写不敏感的精确匹配，可以在mapping中设置keyword字段的小写归一化器：

{
  "mappings": {
    "properties": {
      "stage": {
        "type": "keyword",
        "normalizer": "lowercase_normalizer"
      }
    },
    "settings": {
      "analysis": {
        "normalizer": {
          "lowercase_normalizer": {
            "type": "custom",
            "filter": ["lowercase"]
          }
        }
      }
    }
  }
}

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