Elasticsearch的match_phrase查询slop参数为何无法匹配单查询词文档

1. match_phrase的基础规则 #

match_phrase查询的核心前提是文档必须包含查询字符串的所有词项，slop参数的作用只是允许词项之间存在额外的间隔、或者调整词项的先后顺序，本质是计算词项位置编辑距离的允许阈值，完全不支持缺失任意一个查询词项的场景。
你提到的两个词查询brown fox，不管slop设为7还是更大的数值，只要文档里只出现brown或者只出现fox，都不可能满足短语查询的基础匹配条件，自然匹配不到结果。

2. 你提到的「3个词查询匹配2个词文档」的场景说明 #

这个场景的前提是查询语句经过分析器处理后，有词项被过滤了：比如你的3个查询词里包含停用词（比如the、a这类通用无意义词），会被分析器的停用词过滤模块直接删除，实际参与match_phrase查询的词项只剩下2个，才会匹配到只有2个对应词项的文档，并不是短语查询本身支持缺失查询词项。

3. 需求的正确实现方式 #

如果你需要匹配所有包含brown或者fox的文档，不需要用match_phrase，直接用普通的match查询即可，默认的operator就是or，天然满足你的需求。
如果需要同时兼顾短语匹配的排序优先级（完全匹配brown fox的文档排在前面，仅匹配单个词的文档排在后面），可以用bool查询组合两个子查询，给match_phrase子查询设置更高的权重：

{
  "query": {
    "bool": {
      "should": [
        {
          "match": {
            "your_field_name": "brown fox"
          }
        },
        {
          "match_phrase": {
            "your_field_name": {
              "query": "brown fox",
              "slop": 7,
              "boost": 2
            }
          }
        }
      ]
    }
  }
}

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