Hibernate Search Lucene：一对多关联中单对象多通配符匹配问题

问题分析 #

你当前的查询用should拼接多个通配符条件，导致只要Document的任意Metadata满足其中一个条件就会被匹配。但你的需求是至少有一个Metadata的value同时满足所有通配符条件——比如示例中Document2的两个Metadata分别命中*my*和*val*，但并非同一个Metadata，所以不应被匹配。

解决方案 #

需要使用Hibernate Search的嵌套查询（nested predicate），将所有通配符条件限定在同一个metadataSet元素内，确保所有条件都匹配同一个Metadata对象。

1. 调整实体类的嵌入索引配置 #

确保Document的metadataSet字段在索引时以嵌套结构存储，显式指定要嵌入的字段：

@Entity
@Indexed
@Table(name = "documents")
public class Document{

  @IndexedEmbedded(includePaths = "value") // 明确嵌入Metadata的value字段，保证嵌套结构
  @OneToMany(mappedBy = "document")
  private Set<Metadata> metadataSet = new HashSet<>();
  // 其他字段...
}

2. 修改查询逻辑 #

用nested包裹所有通配符条件，并用must（逻辑AND）组合，强制所有条件匹配同一个Metadata：

// keywords = List.of("*my*", "*val*")
searchSession.search(Document.class)
  .where(f -> f.nested(n -> n
      .path("metadataSet")
      .query(nf -> nf.bool(b -> {
          for(String keyword : keywords){
              b.must(nf.wildcard().field("metadataSet.value").matching(keyword));
          }
      }))
  ))
  .fetch(20); // 根据业务需求调整分页参数

3. 生效原理 #

• nested谓词会强制内部所有条件都作用于同一个嵌入的metadataSet元素（即同一个Metadata对象）。
• must组合条件要求该Metadata的value同时满足所有通配符规则。
• 只有当Document中存在至少一个符合所有条件的Metadata时，才会被查询命中。

验证结果 #

• Document1中存在value="my value"的Metadata，同时满足*my*和*val*，会被匹配。
• Document2的两个Metadata分别满足单个条件，但没有一个能同时命中两个通配符，因此不会被匹配。

补充提示 #

• 确保使用Hibernate Search 6.x及以上版本，该版本对嵌套查询支持更完善。
• 通配符查询*xxx*性能较低，如果是前缀/后缀匹配场景，建议改用prefix查询或配置EdgeNGram分析器实现更高效的自动补全。

内容的提问来源于stack exchange，提问作者Martin Kršek