Hibernate多对多映射自定义HQL未返回预期结果

你遇到的问题是典型的多对多关联中集合过滤不生效的情况，原因在于你当前的JPQL查询只完成了第一步：筛选出至少关联了一个isActive=true的GroceryItem的Keyword，但并没有对Keyword关联的groceryItem集合本身做过滤。当Hibernate延迟加载这个集合时，会执行单独的查询（就是你日志里的第二条SQL），这个查询没有带上isActive的条件，所以会加载所有关联的GroceryItem，导致你看到所有数据都被返回了。

下面给你两种可行的解决方案：

方案一：使用Fetch Join直接加载过滤后的集合 #

修改你的JPQL查询，使用JOIN FETCH来一次性加载符合条件的关联集合，同时加上DISTINCT避免重复的Keyword条目：

@Query("SELECT DISTINCT Ke FROM KeyWordEntity Ke JOIN FETCH Ke.groceryItem Ge WHERE Ke.keyword_id in :id AND Ge.isActive = true ")
public List<KeyWordEntity> findByIds(@Param("id") List<Long> id);

这个方案的优势是简单直接，不需要额外的配置，查询会一次性把符合条件的Keyword和对应的active GroceryItem都加载出来，返回的Keyword对象里的groceryItem集合只会包含isActive=true的条目。

方案二：使用Hibernate过滤器实现全局/按需集合过滤 #

如果需要在多个场景下都过滤掉isActive=false的GroceryItem，可以使用Hibernate的@Filter注解来实现：

1. 在GroceryItemEntity上定义过滤器 #

@Entity
@Table(name = "Grocery")
@FilterDef(name = "activeGroceryFilter", parameters = @ParamDef(name = "activeStatus", type = Boolean.class))
@Filter(name = "activeGroceryFilter", condition = "is_active = :activeStatus")
public class GroceryItemEntity {
    // 你的现有字段...
}

2. 在KeyWordEntity的关联集合上应用过滤器 #

@Entity
public class KeyWordEntity {
    // 你的现有字段...
    
    @ManyToMany(fetch = FetchType.LAZY, mappedBy = "keyWord", cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    @Filter(name = "activeGroceryFilter", condition = "is_active = true")
    private Set<GroceryItemEntity> groceryItem;
}

3. 在查询时启用过滤器 #

需要在调用查询前获取Session并启用过滤器：

@Autowired
private EntityManager entityManager;

public List<KeyWordEntity> getFilteredKeywords(List<Long> ids) {
    Session session = entityManager.unwrap(Session.class);
    session.enableFilter("activeGroceryFilter").setParameter("activeStatus", true);
    return keywordRepository.findByIds(ids);
}

这个方案的优势是可以全局生效，只要启用过滤器，所有加载GroceryItem的地方都会自动过滤掉非active的条目，适合需要在多个查询中保持一致过滤规则的场景。

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