从Hibernate 5迁移至6：能否用纯Query DSL替代Lucene MultiFieldQueryParser？

完全可以用Hibernate Search 6的纯Query DSL实现你要的逻辑，不需要依赖Lucene的MultiFieldQueryParser等底层类，同时也能完美处理@IndexedEmbedded标注的关联实体字段（比如company.name）。

以下是对应你原有逻辑的Hibernate Search 6实现代码：

import org.hibernate.search.engine.search.query.SearchResult;
import org.hibernate.search.mapper.orm.Search;
import org.hibernate.search.mapper.orm.session.SearchSession;

// 获取SearchSession（替代原FullTextEntityManager）
SearchSession searchSession = Search.session(entityManager);

// 构建并执行查询
SearchResult<Service> result = searchSession.search(Service.class)
        .where(f -> {
            // 对应原BooleanJunction逻辑
            var boolPredicate = f.bool();
            
            if (StringUtils.isNotBlank(searchString)) {
                // 多字段全文匹配，替代Lucene的MultiFieldQueryParser
                boolPredicate.must(f.match()
                        // 指定查询字段，包括关联实体的嵌套字段
                        .fields("name", "description", "company.name", "configuration.name")
                        // 指定分析器，和原代码逻辑一致
                        .analyzer("standard")
                        // 设置默认操作符为AND，对应原AND_OPERATOR
                        .operator(org.hibernate.search.engine.search.common.BooleanOperator.AND)
                        .matching(searchString));
            }
            
            return boolPredicate;
        })
        // 获取全部结果，对应原getResultList()
        .fetchAll();

return result.hits();

关键逻辑对应说明： #

• 用SearchSession替代原FullTextEntityManager，是Hibernate Search 6的核心API，彻底实现了API与底层Lucene实现的解耦。
• f.match().fields(...)直接实现多字段匹配：
  • fields参数原生支持company.name这种嵌套路径（前提是Service实体的company字段已标注@IndexedEmbedded，该注解用法与Hibernate Search 5基本兼容）。
  • 通过.operator(BooleanOperator.AND)设置默认逻辑操作符，完全对应原代码的setDefaultOperator(AND_OPERATOR)。
  • .analyzer("standard")指定分析器，和原代码逻辑保持一致。
• 整个查询构建过程完全基于Hibernate Search的DSL，无任何Lucene依赖类，贴合版本6的设计目标。

额外迁移注意点： #

• 实体映射上，@IndexedEmbedded的核心用法与5版本兼容，但部分属性（如prefix）有细微调整，建议对照官方文档确认映射正确性。
• 如果需要分页、排序等扩展功能，可直接在链式调用中添加，例如.fetch(20)获取前20条结果，.sort(f -> f.field("name"))按名称排序。

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