JPA关联抓取查询中如何过滤关联实体tProducts？

首先需要明确核心避坑点：如果直接在原查询的WHERE子句中追加tProducts.active = true的过滤条件，原本的LEFT JOIN语义会被破坏为INNER JOIN，最终只能返回“至少包含一个激活产品”的Trfi实体，那些没有激活产品但符合sedId筛选条件的Trfi会被从结果集中漏掉，完全达不到“返回所有目标Trfi，仅对其加载的tProducts关联做激活状态过滤”的目的。

1. 标准JPA语法（JPA 2.1+ 原生支持，兼容度最高） #

直接在JOIN FETCH的关联语句上通过ON子句追加过滤条件，过滤逻辑只作用于被抓取的关联集合，不会改变主表Trfi的筛选范围，修改后的代码如下：

value = "SELECT DISTINCT(t) FROM Trfi t " +
    "LEFT JOIN FETCH t.trfiProductCollection tProducts " +
    // 仅对抓取的tProducts做激活状态过滤
    "  ON tProducts.active = true " +
    "LEFT JOIN FETCH tProducts.productModel pModel " +
    "LEFT JOIN FETCH t.trfiPaymentCollection tPayment " +
    "WHERE t.sedId IN (:sessionIds) ",
countQuery = "SELECT COUNT (DISTINCT t) FROM Trfi t " +
    // count查询不需要关联抓取，原有JOIN逻辑可保持不变
    "JOIN t.trfiProductCollection tProducts " +
    "JOIN tProducts.productModel pModel " +
    "JOIN pModel.provider provider " +
    "JOIN t.trfiPaymentCollection tPayment " +
    "WHERE t.sedId IN (:sessionIds) "
)
List<Trfi> getTrfiListBySessionsId(@Param("sessionIds") List<Integer> sessionIds);

实现效果说明：

• 所有匹配sedId条件的Trfi实体都会正常返回，哪怕该Trfi下没有任何激活的tProducts（此时trfiProductCollection属性为空集合）
• 被抓取的tProducts集合只会保留active为true的记录，挂在tProducts下的pModel关联也会自动仅加载激活产品对应的模型数据，不需要额外追加过滤条件
• countQuery的原有逻辑不需要调整：计数本身是统计符合sedId条件的Trfi总数，和tProducts的激活状态无耦合；如果计数逻辑也需要排除无激活产品的Trfi，只需要在countQuery对应的JOIN语句上追加相同的ON过滤条件即可。

2. 低版本JPA兼容方案 #

如果项目使用的JPA版本低于2.1，不支持JOIN FETCH的ON子句，可以通过EntityGraph定义关联加载规则，实现单个查询级别的关联属性过滤，不需要改动实体全局映射。

3. 全局过滤方案（适合统一规则场景） #

如果项目中所有场景加载Trfi的trfiProductCollection关联时，都需要仅获取激活状态的产品，可以直接在实体的关联映射上添加@Where注解：

// Trfi实体中trfiProductCollection属性的映射定义
@OneToMany(mappedBy = "trfi")
@Where(clause = "active = true")
private Collection<TrfiProduct> trfiProductCollection;

这种方式不需要修改现有JPQL语句，所有查询加载该关联时都会自动追加active过滤条件，但缺点是规则全局生效，无法针对单个查询灵活调整过滤逻辑。

• 严禁将tProducts.active = true直接追加在主WHERE子句中，否则LEFT JOIN会被数据库优化器转换为INNER JOIN，直接漏掉无激活产品的Trfi实体
• 一对多关联FETCH时必须保留SELECT DISTINCT关键字，否则会因为多表关联返回重复的Trfi实体对象
• ON子句的过滤作用域仅针对当前JOIN的关联表，不会影响其他关联表的加载逻辑

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