跨不同索引组合Hibernate Search查询的最优方案

嘿，我正好解决过类似的问题！你现在的问题根源在于拆分查询导致的大量ID拼接，其实用Hibernate Search的嵌入式索引+联合查询就能彻底规避这个异常，而且性能更优。下面是具体的实现步骤：

第一步：修改Person实体，嵌入Address的索引字段 #

你需要在Person的addressSet字段上添加@IndexedEmbedded注解，这样Hibernate Search会把关联的Address实体的字段（包括空间坐标）嵌入到Person的索引文档中，让你可以在同一个查询里同时过滤年龄和空间条件。

修改后的Person实体字段：

@IndexedEmbedded // 核心注解：将Address的字段嵌入到Person索引中
@org.hibernate.annotations.Cache(usage = org.hibernate.annotations.CacheConcurrencyStrategy.READ_WRITE)
@ManyToMany
@Cascade({org.hibernate.annotations.CascadeType.SAVE_UPDATE})
@JoinTable(name = "person_address", joinColumns = {@JoinColumn(name = "person_id")}, inverseJoinColumns = {@JoinColumn(name = "address_id")})
private Set<Address> addressSet = new HashSet<>();

第二步：编写联合查询，同时过滤年龄和空间范围 #

现在你可以直接针对Person索引编写查询，同时加入年龄区间和空间范围的条件，不需要再单独查询地址ID。

如果你用的是Hibernate Search 6（推荐的新版本）：

// 获取SearchSession
SearchSession searchSession = Search.session(entityManager);

// 定义查询参数
int minAge = 20;
int maxAge = 30;
double centerLongitude = 116.403874; // 示例中心点经度
double centerLatitude = 39.914885;  // 示例中心点纬度

// 执行联合查询
List<Person> result = searchSession.search(Person.class)
        .where(f -> f.bool()
                // 年龄区间筛选
                .must(f.range().field("age").between(minAge, maxAge))
                // 空间范围筛选：指定位置5公里内的地址
                .must(f.spatial().within().field("addressSet.xCoord", "addressSet.yCoord")
                        .circle(centerLongitude, centerLatitude, Distance.ofKilometers(5))))
        .fetchHits(20); // 按需调整返回数量

如果你用的是Hibernate Search 5：

// 获取FullTextEntityManager
FullTextEntityManager fullTextEntityManager = Search.getFullTextEntityManager(entityManager);

// 构建QueryBuilder
QueryBuilder qb = fullTextEntityManager.getSearchFactory()
        .buildQueryBuilder().forEntity(Person.class).get();

// 定义查询参数
int minAge = 20;
int maxAge = 30;
double centerLongitude = 116.403874;
double centerLatitude = 39.914885;

// 构建联合查询
org.apache.lucene.search.Query query = qb.bool()
        // 年龄区间条件
        .must(qb.range().onField("age").from(minAge).to(maxAge).createQuery())
        // 空间范围条件（注意Hibernate Search 5中纬度在前）
        .must(qb.spatial().within(5, Unit.KM)
                .ofLatitude(centerLatitude).andLongitude(centerLongitude)
                .onFields("addressSet.yCoord", "addressSet.xCoord")
                .createQuery())
        .createQuery();

// 执行查询
FullTextQuery fullTextQuery = fullTextEntityManager.createFullTextQuery(query, Person.class);
List<Person> result = fullTextQuery.getResultList();

第三步：重建索引（重要！） #

因为你修改了实体的索引配置（添加了@IndexedEmbedded），所以需要重新构建一次索引，确保Person的索引文档中包含了Address的嵌入字段：

// 启动批量索引器，重建Person和Address的索引
Search.massIndexer(entityManager, Person.class, Address.class)
        .startAndWait();

为什么这个方案更好？ #

• 彻底避免BooleanQueryTooManyClauses异常：不需要再查询大量地址ID并拼接成布尔查询，所有条件在同一个索引查询中完成。
• 性能更优：单索引查询比跨索引关联查询的响应速度更快，减少了数据库和索引的交互次数。
• 代码更简洁：不需要拆分两次查询，逻辑更清晰易维护。

额外注意事项 #

• 确保Address实体中的xCoord和yCoord已经正确标记了@Longitude和@Latitude（你已经做到了，没问题）。
• 如果Person和Address的关联是双向的，不需要额外配置，@IndexedEmbedded只需要在Person的addressSet字段上添加即可。
• 如果你担心嵌入字段导致索引体积过大，可以通过@IndexedEmbedded(includePaths = {"xCoord", "yCoord"})指定只嵌入需要的字段，进一步优化索引大小。

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