Spring Boot Elasticsearch调整分词匹配长度实现3字符检索

你的问题核心是默认的english分词器不支持短词的子串/前缀匹配，且Elasticsearch默认分词逻辑不会处理3字符级别的片段拆分。以下是具体调整方案：

1. 自定义Ngram分词器 #

在你的SearchMappingConfig类中添加自定义分词器配置，通过ngram过滤器实现3字符级别的分词拆分：

import org.hibernate.search.backend.elasticsearch.analysis.ElasticsearchAnalysisConfigurationContext;
import org.hibernate.search.mapper.orm.mapping.HibernateOrmSearchMappingConfigurer;
import org.springframework.context.annotation.Configuration;

@Configuration
public class SearchMappingConfig implements HibernateOrmSearchMappingConfigurer {

    @Override
    public void configure(HibernateOrmSearchMappingConfigurationContext context) {
        context.backend().analysis(configurer -> {
            // 定义ngram过滤器，设置最小分词长度为3
            configurer.filter("my_ngram_filter")
                    .type("ngram")
                    .param("min_gram", 3)
                    .param("max_gram", 20);

            // 基于english分词器扩展，加入ngram过滤器
            configurer.analyzer("english_ngram")
                    .type("custom")
                    .tokenizer("standard")
                    .tokenFilter("lowercase")
                    .tokenFilter("english_stop")
                    .tokenFilter("english_keywords")
                    .tokenFilter("english_stemmer")
                    .tokenFilter("english_possessive_stemmer")
                    .tokenFilter("my_ngram_filter");
        });
    }
}

2. 修改实体类字段注解 #

将需要支持短词检索的字段，替换为自定义的english_ngram分词器：

import org.hibernate.search.mapper.pojo.mapping.definition.annotation.FullTextField;
import org.hibernate.search.mapper.pojo.mapping.definition.annotation.Indexed;
import javax.persistence.Entity;

@Indexed
@Entity
public class User {

    // 其他字段...

    @FullTextField(analyzer = "english_ngram")
    private String username;

    // getter/setter方法...
}

3. 兼顾精确检索的优化方案 #

如果需要同时保留原有的精确检索能力（比如搜索"Smith"精准匹配），可以使用@MultiField注解为同一个字段配置双索引：

import org.hibernate.search.mapper.pojo.mapping.definition.annotation.MultiField;

@MultiField(
        main = @FullTextField(analyzer = "english"),
        additional = {
                @FullTextField(name = "username_ngram", analyzer = "english_ngram")
        }
)
private String username;

查询时针对username_ngram字段执行短词搜索，针对主字段执行精确搜索即可。

4. 关键注意事项 #

• 修改配置后必须重建索引，旧索引不会自动应用新的分词规则。可以通过以下代码触发索引重建：

  @Autowired
  private SearchSession searchSession;
  
  public void rebuildUserIndexes() {
      try {
          searchSession.massIndexer(User.class)
                  .startAndWait();
      } catch (InterruptedException e) {
          Thread.currentThread().interrupt();
          throw new RuntimeException("索引重建失败", e);
      }
  }
  

• 查询时使用match查询而非term查询，确保走分词匹配逻辑：

  List<User> searchResult = searchSession.search(User.class)
          .where(f -> f.match().field("username").matching("Bob"))
          .fetchHits(20);
  

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