Elasticsearch自动补全异常：前缀词可匹配，完整词无搜索结果

存在名为“Recreio dos Bandeirantes”的社区，输入前缀词“bandeirant”时可匹配到该社区，但输入完整词“bandeirantes”却无法找到。以下是相关配置、查询及响应信息，以及对应的解决方法：

相关配置与查询信息 #

查询语句 #

{
  query: {
    bool: {
      must: [
        {
          match: {
            'city.name': city,
          },
        },
        {
          match: {
            'city.state': state,
          },
        },
        {
          match: {
            keyword: {
              query, // 此处query为'bandeirant'或'bandeirantes'
            },
          },
        },
      ],
    },
  },
  highlight: {
    fields: {
      keyword: {
        number_of_fragments: 9,
      },
    },
  },
  size: 20,
}

社区完整值 #

Recreio dos Bandeirantes, Rio de Janeiro, RJ

字段映射 #

{
  "search-neighborhood-01": {
    "mappings": {
      "properties": {
        "city": {
          //.....
        },
        "keyword": {
          "type": "text",
          "analyzer": "autocomplete",
          "search_analyzer": "standard"
        },
        "name": {
          "type": "text",
          "analyzer": "autocomplete",
          "search_analyzer": "standard"
        }
      }
    }
  }
}

分析器配置 #

{
  "search-neighborhood-01": {
    "settings": {
      "index": {
        // .......
        "analysis": {
          "filter": {
            "autocomplete_filter": {
              "token_chars": [
                "letter"
              ],
              "min_gram": "1",
              "type": "edge_ngram",
              "max_gram": "10"
            }
          },
          "analyzer": {
            "autocomplete": {
              "filter": [
                "lowercase",
                "autocomplete_filter",
                "asciifolding"
              ],
              "type": "custom",
              "tokenizer": "standard"
            }
          }
        },
        // .....
      }
    }
  }
}

响应情况 #

• 输入bandeirant时：可返回目标社区，响应片段如下：

// .....
{
 //.....
  "_source": {
    "city": {
      "name": "Rio de Janeiro",
      "state": "RJ",
      "keyword": "Rio de Janeiro, RJ"
    },
    "name": "Recreio dos Bandeirantes",
    "keyword": "Recreio dos Bandeirantes, Rio de Janeiro, RJ"
  },
  "highlight": {
    "keyword": [
      "Recreio dos <em>Bandeirantes</em>, Rio de Janeiro, RJ"
    ]
  }
}

• 输入bandeirantes时：响应为空

问题原因分析 #

核心问题出在edge_ngram过滤器的max_gram设置：

• 配置中max_gram设为10，意味着索引时生成的最大前缀词长度为10。
• 目标社区名称中的bandeirantes小写后长度为11，索引时无法生成完整的11位前缀词。
• 输入bandeirant（长度10）时，刚好匹配索引中生成的最长前缀词；输入bandeirantes（长度11）时，标准分析器会将其处理为完整的11长度词，索引中无对应匹配项，导致查询为空。

解决方案 #

1. 调整edge_ngram过滤器的max_gram值 #

将autocomplete_filter中的max_gram调整为足够覆盖业务中最长查询词的长度，比如设为20：

"autocomplete_filter": {
  "token_chars": [
    "letter"
  ],
  "min_gram": "1",
  "type": "edge_ngram",
  "max_gram": "20" // 增大至覆盖最长可能的查询词长度
}

2. 重建索引并重新导入数据 #

由于Elasticsearch索引的分析器配置无法在创建后修改，需执行以下步骤：

• 删除原索引search-neighborhood-01
• 使用更新后的配置创建新索引
• 重新导入所有社区数据

3. 可选优化：统一搜索与索引分析器 #

如果希望同时支持前缀匹配和完整词匹配，可将search_analyzer改为与索引分析器一致的autocomplete，这样查询词也会被拆分为前缀词，提升匹配灵活性（需注意可能带来的结果泛化问题）。调整后的字段映射：

"keyword": {
  "type": "text",
  "analyzer": "autocomplete",
  "search_analyzer": "autocomplete"
},
"name": {
  "type": "text",
  "analyzer": "autocomplete",
  "search_analyzer": "autocomplete"
}

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