Elasticsearch 7.16.2 must_not生产环境失效，无法排除stock_code=L1的产品

我需要编写Elasticsearch查询排除stock_code为L1的产品，本地环境中三种查询变体均能正常工作，但在预发布和生产环境中完全无法生效。我们使用的是Elasticsearch 7.16.2版本，产品索引中stock_code的映射类型为keyword，预发布与生产环境共用同一服务器但使用不同的索引。

尝试过的查询语句 #

变体1 #

{
    "bool": {
        "must": [],
        "must_not": [{
            "term": {
                "stock_code": {
                    "value": "L1"
                }
            }
        }]
    }
}

变体2 #

{
    "bool": {
        "must": [],
        "must_not": [],
        "filter": {
            "bool": {
                "must_not": [{
                    "term": {
                        "stock_code": {
                            "value": "L1"
                        }
                    }
                }]
            }
        }
    }
}

变体3 #

{
    "bool": {
        "must": [{
            "bool": {
                "must_not": [{
                    "term": {
                        "stock_code": {
                            "value": "L1"
                        }
                    }
                }]
            }
        }],
        "must_not": []
    }
}

产品索引映射 #

{
    "settings": {
        "index": {
            "number_of_shards": 3,
            "number_of_replicas": 2
        },
        "mappings": {
            "properties": {
                ....
                "stock_code": {
                    "type": "keyword"
                }
                ....
            }
        }
    }
}

排查与解决步骤 #

1. 验证预生产环境的实际索引映射
   本地的映射配置不代表预生产环境索引的真实状态，直接通过ES API查询目标索引的stock_code字段映射：

GET /你的预生产索引名/_mapping/field/stock_code

确认该字段确实是keyword类型，排查是否存在动态映射错误（比如字段名拼写错误、索引创建时映射未正确加载）。

2. 检查预生产环境的实际数据值
   数据中可能存在大小写、空格或特殊字符差异，比如实际值是l1、 L1（带前导空格）或L1 （带后缀空格），导致term查询无法匹配。用聚合查询查看所有stock_code的实际值：

{
  "aggs": {
    "distinct_stock_codes": {
      "terms": {
        "field": "stock_code",
        "size": 100
      }
    }
  },
  "size": 0
}

根据聚合结果调整查询的value，匹配真实数据。

3. 排查查询执行上下文

• 确认查询是否被外层逻辑覆盖，比如是否存在其他must条件导致must_not被忽略；
• 核对查询的目标索引名，确保没有误查其他索引。

4. 测试最简查询
   在预生产环境执行无冗余逻辑的最简查询，排除干扰：

{
  "query": {
    "bool": {
      "must_not": [
        { "term": { "stock_code": "L1" } }
      ]
    }
  }
}

如果该查询生效，说明之前的变体中冗余逻辑导致了问题；如果仍不生效，继续排查数据或索引状态。

5. 检查索引分片健康状态
   预生产环境的分片可能存在未分配、异常或数据同步问题，执行命令查看索引健康：

GET /_cluster/health/你的预生产索引名

确保所有分片处于green状态，无数据缺失。

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