Solr 8模糊搜索是否存在字符串长度限制？

问题现象 #

短字符串带~1编辑距离的模糊搜索可正常命中结果，但长字符串仅精确搜索有命中，模糊搜索返回0结果：

• 短字符串查询：
  • 精确：http://localhost:8983/solr/search/select?indent=true&q=item_signature:averysimpletitle → hits=2
  • 模糊：http://localhost:8983/solr/search/select?indent=true&q=item_signature:averysimpletitle~1 → hits=2
• 长字符串查询：
  • 精确：http://localhost:8983/solr/search/select?indent=true&q=item_signature:cantileveredtandemstatorofmoderateaerodynamicloading → hits=3
  • 模糊：http://localhost:8983/solr/search/select?indent=true&q=item_signature:cantileveredtandemstatorofmoderateaerodynamicloading~1 → hits=0

核心原因 #

Lucene（Solr底层）的模糊查询默认存在候选词扩展数量限制：

• fuzzy.maxExpansions默认值为50，长字符串做编辑距离1的模糊匹配时，生成的候选term数量会超过这个阈值，超出部分被直接截断，导致无法匹配到实际存在的文档。
• 另外，长字符串的编辑距离占比极低（比如长度50的字符串，编辑距离1对应的相似度为98%），若字段配置了严格的相似度阈值，也可能过滤掉结果。

解决方案 #

1. 临时调整查询参数 #

在模糊查询请求中显式增大fuzzy.maxExpansions值，示例：

http://localhost:8983/solr/search/select?indent=true&q=item_signature:cantileveredtandemstatorofmoderateaerodynamicloading~1&fuzzy.maxExpansions=1000

若需要更宽松的匹配，可同时调整fuzzy.minSimilarity（如设为0.9），但通常增大扩展数即可解决问题。

2. 全局配置字段参数 #

在Solr的schema配置文件（如managed-schema）中，为item_signature字段对应的fieldType添加模糊查询参数，实现永久生效：

<fieldType name="string" class="solr.StrField" sortMissingLast="true">
  <analyzer type="query">
    <tokenizer class="solr.KeywordTokenizerFactory"/>
  </analyzer>
  <!-- 配置模糊查询参数 -->
  <fuzzyQuery>
    <maxExpansions>1000</maxExpansions>
    <minSimilarity>0.9</minSimilarity>
  </fuzzyQuery>
</fieldType>

配置完成后重启Solr即可生效。

3. 验证字段类型 #

确保item_signature字段使用不分词的类型（如string），因为分词字段的模糊查询是针对单个term而非整个字段内容。若字段为分词类型，需改为string或使用KeywordTokenizer的text类型，保证精确和模糊匹配都基于完整字段值。

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