如何让Hibernate SearchSession返回属性唯一的搜索结果？

我正在Java中使用Hibernate的SearchSession类执行数据库搜索，当前用于搜索表的代码如下：

SearchSession searchSession = Search.session(entityManagerFactory.unwrap(SessionFactory.class).withOptions()
                .tenantIdentifier("locations").openSession());

SearchResult<Location> result = searchSession.search(Location.class)
                .where(f -> f.bool()
                        .must(f.match()
                                .field("locationName")
                                .matching(phrase).fuzzy())
                ).fetch(page * limit, limit);

该搜索可正常返回数据库结果，但locationName列无唯一性约束，数据库中存在多条locationName值相同的记录，导致在应用UI中显示时出现重复值（尽管这些记录在数据库中本身是唯一的）。

请问是否可以让SearchSession仅返回未出现过相同属性值（如locationName）的结果？目前无法为数据库表添加唯一性约束，希望能在会话层面处理去重，而非在获取搜索结果后单独去重。

可以通过Hibernate Search的**折叠（collapse）**功能实现会话层面的去重，根据locationName字段折叠结果，确保每个locationName值仅返回一条匹配记录。

基础折叠实现 #

修改后的搜索代码如下：

SearchSession searchSession = Search.session(entityManagerFactory.unwrap(SessionFactory.class).withOptions()
                .tenantIdentifier("locations").openSession());

SearchResult<Location> result = searchSession.search(Location.class)
                .where(f -> f.bool()
                        .must(f.match()
                                .field("locationName")
                                .matching(phrase).fuzzy())
                )
                // 按locationName字段折叠，每个值仅返回第一条匹配记录
                .collapse(f -> f.field("locationName"))
                .fetch(page * limit, limit);

自定义折叠组内返回规则 #

如果需要指定折叠后返回组内的哪条记录（比如按ID升序取最早的记录），可以结合折叠的排序配置：

SearchResult<Location> result = searchSession.search(Location.class)
                .where(f -> f.bool()
                        .must(f.match()
                                .field("locationName")
                                .matching(phrase).fuzzy())
                )
                .collapse(f -> f.field("locationName")
                        // 配置组内排序，确保返回符合规则的第一条记录
                        .sort(f -> f.field("id").asc())
                )
                .fetch(page * limit, limit);

注意事项 #

• 确保locationName字段在Hibernate Search的索引配置中支持折叠：字符串字段默认支持，但如果字段使用了特殊分词分析器，可能需要将字段映射调整为Keyword类型，避免分词后无法精确分组。
• 折叠会改变分页逻辑：分页是基于折叠后的去重结果数量，而非原始匹配的总记录数。

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