如何配置Elasticsearch实现带词间距限制的edge_ngram前缀匹配？

需求：实现检索请求仅返回目标token之间少于5个词的结果。

现有索引settings配置：

{
  "settings": {
    "index": {
      "analysis": {
        "filter": {
          "stopWords": {
            "type": "stop",
            "stopwords": [
              "_english_"
            ]
          }
        },
        "normalizer": {
          "lowercaseNormalizer": {
            "filter": [
              "lowercase",
              "asciifolding"
            ],
            "type": "custom",
            "char_filter": []
          }
        },
        "analyzer": {
          "autoCompleteAnalyzer": {
            "filter": [
              "lowercase"
            ],
            "type": "custom",
            "tokenizer": "autoCompleteTokenizer"
          },
          "autoCompleteSearchAnalyzer": {
            "type": "custom",
            "tokenizer": "lowercase"
          },
          "charGroupAnalyzer": {
            "filter": [
              "lowercase"
            ],
            "type": "custom",
            "tokenizer": "charGroupTokenizer"
          }
        },
        "tokenizer": {
          "charGroupTokenizer": {
            "type": "char_group",
            "max_token_length": "20",
            "tokenize_on_chars": [
              "whitespace",
              "-",
              "\n"
            ]
          },
          "autoCompleteTokenizer": {
            "token_chars": [
              "letter"
            ],
            "min_gram": "3",
            "type": "edge_ngram",
            "max_gram": "20"
          }
        }
      }
    }
  }
}

映射mappings配置：

{
  "mappings": {
    "_doc": {
      "properties": {
        "description": {
          "properties": {
            "name": {
              "type": "text",
              "fields": {
                "keyword": {
                  "type": "keyword",
                  "ignore_above": 64
                }
              },
              "analyzer": "autoCompleteAnalyzer",
              "search_analyzer": "autoCompleteSearchAnalyzer"
            },
            "text": {
              "type": "text",
              "analyzer": "charGroupAnalyzer"
            }
          }
        }
      }
    }
  }
}

当前使用的bool查询：

{
    "query": {
        "bool": {
            "must": [
                {
                    "multi_match": {
                        "fields": [
                            "description.name"
                        ],
                        "operator": "and",
                        "query": "rounded elephant",
                        "fuzziness": 1
                    }
                },
                {
                    "match_phrase": {
                        "description.text": {
                            "analyzer": "charGroupAnalyzer",
                            "query": "rounded elephant",
                            "slop": 5,
                            "boost": 20
                        }
                    }
                }
            ]
        }
    }
}

问题现象与原因 #

• 现象：使用完整词（如rounded elephant）时，可正常检索到类似‘... rounded very interesting elephant ...’的文档，但输入前缀词（如round eleph）时匹配失败。
• 原因：description.name字段使用edge_ngram分词，而description.text字段使用普通词分词，两者分词逻辑不一致，导致前缀查询时无法匹配到对应结果。

提问 #

如何配置映射与查询，实现带词间距限制的edge_ngram匹配？

要实现前缀词也能匹配且满足词间距少于5个词的要求，核心是让索引和查询的分词逻辑对齐，同时保留词位置的间距限制。具体调整如下：

1. 更新索引Settings，新增短语前缀分析器 #

在现有analysis配置中，新增结合词切分和edge_ngram的分析器，同时优化原有分词器的停用词过滤：

{
  "settings": {
    "index": {
      "analysis": {
        "normalizer": {
          "lowercaseNormalizer": {
            "filter": [
              "lowercase",
              "asciifolding"
            ],
            "type": "custom",
            "char_filter": []
          }
        },
        "analyzer": {
          "autoCompleteAnalyzer": {
            "filter": [
              "lowercase"
            ],
            "type": "custom",
            "tokenizer": "autoCompleteTokenizer"
          },
          "autoCompleteSearchAnalyzer": {
            "type": "custom",
            "tokenizer": "lowercase"
          },
          "charGroupAnalyzer": {
            "filter": [
              "lowercase",
              "stopWords"
            ],
            "type": "custom",
            "tokenizer": "charGroupTokenizer"
          },
          // 新增：索引时用的短语前缀分析器，先切词再生成edge_ngram
          "phrasePrefixAnalyzer": {
            "type": "custom",
            "tokenizer": "charGroupTokenizer",
            "filter": [
              "lowercase",
              "stopWords",
              "edge_ngram_filter"
            ]
          },
          // 新增：查询时用的短语前缀分析器，仅切词和过滤停用词
          "phrasePrefixSearchAnalyzer": {
            "type": "custom",
            "tokenizer": "charGroupTokenizer",
            "filter": [
              "lowercase",
              "stopWords"
            ]
          }
        },
        "tokenizer": {
          "charGroupTokenizer": {
            "type": "char_group",
            "max_token_length": "20",
            "tokenize_on_chars": [
              "whitespace",
              "-",
              "\n"
            ]
          },
          "autoCompleteTokenizer": {
            "token_chars": [
              "letter"
            ],
            "min_gram": "3",
            "type": "edge_ngram",
            "max_gram": "20"
          }
        },
        "filter": {
          "stopWords": {
            "type": "stop",
            "stopwords": ["_english_"]
          },
          // 新增edge_ngram过滤器，参数和原自动补全分词器一致
          "edge_ngram_filter": {
            "type": "edge_ngram",
            "min_gram": 3,
            "max_gram": 20,
            "token_chars": ["letter"]
          }
        }
      }
    }
  }
}

2. 修改Mappings，给text字段添加短语前缀子字段 #

在description.text下新增专门用于前缀短语匹配的子字段，绑定上面定义的分析器：

{
  "mappings": {
    "_doc": {
      "properties": {
        "description": {
          "properties": {
            "name": {
              "type": "text",
              "fields": {
                "keyword": {
                  "type": "keyword",
                  "ignore_above": 64
                }
              },
              "analyzer": "autoCompleteAnalyzer",
              "search_analyzer": "autoCompleteSearchAnalyzer"
            },
            "text": {
              "type": "text",
              "analyzer": "charGroupAnalyzer",
              "fields": {
                // 新增：支持前缀短语匹配的子字段
                "phrase_prefix": {
                  "type": "text",
                  "analyzer": "phrasePrefixAnalyzer",
                  "search_analyzer": "phrasePrefixSearchAnalyzer"
                }
              }
            }
          }
        }
      }
    }
  }
}

3. 调整查询语句，使用match_phrase_prefix实现需求 #

直接针对新增的description.text.phrase_prefix字段使用match_phrase_prefix查询，通过slop参数控制词间距：

{
  "query": {
    "match_phrase_prefix": {
      "description.text.phrase_prefix": {
        "query": "round eleph",
        "slop": 5,  // 限制两个目标token之间最多间隔5个词
        "boost": 20,
        "max_expansions": 10  // 控制前缀扩展数量，避免性能损耗
      }
    }
  }
}

方案说明 #

• 索引阶段：text.phrase_prefix字段先按词切分（保留词位置），再对每个词生成edge_ngram，既支持前缀匹配，又能记录词的相对位置。
• 查询阶段：输入的前缀词会被切分成单个词，匹配索引中的edge_ngram，同时slop:5保证两个词之间的间隔不超过5个词，满足需求。
• 如果需要同时匹配description.name字段，可以在bool查询中加入对应的multi_match，确保name字段的查询逻辑也使用前缀分析器对齐。

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