AWS OpenSearch模糊补全搜索完整术语无结果，截断后正常

问题场景 #

我在Node.js应用中使用elasticsearch模块查询AWS OpenSearch的模糊补全索引时遇到异常：搜索完整术语Rome–Fiumicino Leonardo da Vinci International Airport无结果返回，但将该术语截断至50字符以内时，能正常获取结果。

查询代码如下：

const result = await elasticsearch.search({
  index: 'myIndex',
  body: {
    suggest: {
      fuzzinessZero: {
        text,
        completion: {
          field: 'name_suggest',
          fuzzy: {
            fuzziness: 0,
          },
          contexts,
        },
      },
      fuzzinessOne: {
        text,
        completion: {
          field: 'name_suggest',
          fuzzy: {
            fuzziness: 1,
          },
          contexts,
        },
      },
      fuzzinessTwo: {
        text,
        completion: {
          field: 'name_suggest',
          fuzzy: {
            fuzziness: 2,
          },
          contexts,
        },
      },
    },
  }
})

另外，fuzzinessOne的返回结果中，text字段被截断至50字符，但_source里存储了完整的目标术语及其他组合值。

索引创建时的设置：

settings: {
  analysis: {
    filter: {
      autocomplete_filter: {
        type: 'edge_ngram',
        min_gram: 2,
        max_gram: 20,
      },
      shingle_filter: {
        type: 'shingle',
        max_shingle_size: 3,
      },
    },
    analyzer: {
      autocomplete: {
        type: 'custom',
        tokenizer: 'standard',
        filter: ['lowercase', 'shingle_filter', 'asciifolding'],
      },
    },
  },
}

问题原因 #

1. 补全字段默认长度限制：AWS OpenSearch的completion类型字段默认携带max_input_length参数，默认值为50。当输入文本长度超过该值时，会被自动截断，导致完整术语无法匹配索引内容——你看到结果中text被截断至50字符，正是该机制导致。
2. 字段映射配置缺失：虽然索引定义了autocomplete分析器，但name_suggest字段未配置足够大的max_input_length，也可能未将分析器与字段关联。

解决步骤 #

1. 更新字段映射，调整长度限制 #

如果索引已存在，需先关闭索引，更新映射后重新打开：

// 关闭索引
await elasticsearch.indices.close({ index: 'myIndex' });

// 更新name_suggest字段映射
await elasticsearch.indices.putMapping({
  index: 'myIndex',
  body: {
    properties: {
      name_suggest: {
        type: 'completion',
        analyzer: 'autocomplete', // 关联自定义分析器
        max_input_length: 200, // 设置足够容纳长术语的长度，最大支持1000
        contexts: [/* 保留原有上下文配置 */]
      }
    }
  }
});

// 重新打开索引
await elasticsearch.indices.open({ index: 'myIndex' });

2. 重新索引数据 #

映射更新后，需要重新导入所有数据，确保新的字段配置生效。

3. 验证查询 #

重新搜索完整术语，此时应能正常返回结果，且text字段不会再被截断。

补充提示 #

• max_input_length最大值为1000，可根据实际术语长度调整。
• 确认autocomplete分析器已正确绑定到name_suggest字段，否则补全的分词逻辑可能不符合预期。

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