Elasticsearch邻近搜索问题：限定Token间距≤K值的查询无效

问题原因 #

你当前的查询逻辑里，phrase_slop参数仅对短语查询生效，但如果你的query参数只是传入"united AND airlines"，本质是两个独立词项的逻辑与匹配，并不会触发短语匹配规则，所以phrase_slop根本没起作用，导致结果里两个词的间距不受限制。

解决方案 #

方案1：修改query_string的查询语法 #

把查询内容改成带slop的短语格式，用双引号包裹两个词，末尾加~2（表示允许的最大间距），这样就能触发短语匹配的位置控制，且支持词序颠倒（slop=2足够覆盖词序交换的位置移动需求）。

修改后的查询结构：

query = {
    "size": limit,
    "query": {
        "query_string": {
            "query": "\"united airlines\"~2",
            "default_operator": "AND"
        }
    }
}

方案2：使用Span Near查询（更精准） #

如果需要更严格的位置控制，推荐用Elasticsearch专门的span_near查询，它专为词项位置关系设计，能精准控制间距和词序。

示例查询（替换content为你的实际文本字段名）：

query = {
    "size": limit,
    "query": {
        "span_near": {
            "clauses": [
                {"span_term": {"content": "united"}},
                {"span_term": {"content": "airlines"}}
            ],
            "slop": 2,
            "in_order": false,
            "collect_payloads": false
        }
    }
}

• slop:2：控制两个词之间的最大间距（包括词序交换的情况）
• in_order: false：允许两个词以任意顺序出现
• collect_payloads: false：不需要收集payload时可以关闭，提升性能

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