ElasticSearch仅2字符simple_query_string查询无结果原因咨询

字段映射定义如下：

identifierNumber: {
  type: "keyword",
  fields: { text: { type: "text" } },
},

该字段的值示例为22-001、22-002等。执行以下Elasticsearch查询：

{
    "query": {
        "bool": {
            "filter": [
                {
                    "term": {
                        "status": "NEW"
                    }
                }
            ],
            "must": [
                {
                    "simple_query_string": {
                        "query": "22 22~",
                        "fields": [
                            "title^3",
                            "identifierNumber^2"
                        ],
                        "lenient": true
                    }
                }
            ]
        }
    },
    "sort": []
}

查询返回0条结果，但将simple_query_string的query改为22001或22-001时能返回相关结果，询问仅用2字符的22 22~查询无法生效的原因。

1. keyword主字段的匹配特性 #

identifierNumber主字段是keyword类型，该类型字段仅支持精确匹配——只有查询字符串与字段值完全一致时才会命中。你的字段值是22-001这类带分隔符的字符串，22与字段值完全不匹配，因此主字段无法命中任何结果。

2. 未指定查询text子字段 #

你在查询字段中指定的是identifierNumber，而非identifierNumber.text。identifierNumber.text是text类型子字段，默认standard分词器会将22-001拆分为22和001两个词项。如果查询该子字段，22就能匹配到对应文档，但当前查询并未用到这个子字段。

3. 模糊查询的编辑距离限制 #

simple_query_string中的22~是模糊查询，默认允许的编辑距离为1（即最多1个字符的增删改）。22与22-001之间的编辑距离为3（需要添加-001三个字符），远超默认限制，因此模糊查询也无法命中。

为何22-001和22001能生效？ #

• 22-001：与identifierNumber主字段的keyword值完全一致，触发精确匹配命中。
• 22001：大概率是title字段中存在包含该字符串的内容，或title字段的分词结果能匹配到该查询字符串。

• 修改查询字段：将fields中的identifierNumber^2改为identifierNumber.text^2，让查询命中分词后的text子字段，22就能匹配到对应文档。
• 使用wildcard查询：若需基于keyword字段做部分匹配，可以在bool查询中添加wildcard条件（如{"wildcard": {"identifierNumber": "*22*"}}），但注意wildcard查询性能较低，数据量大时不推荐。
• 配置ngram分词器：若需要更灵活的部分匹配，可以给identifierNumber.text配置ngram分词器，提前将字符串拆分为短词项（比如2-3字符的组合），这样任意短片段都能快速匹配。

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