Criteria API左关联On谓词失效：无法过滤关联实体Active状态

你遇到的核心问题是JPA的WHERE子句仅用于过滤主实体（ErrorType）是否被纳入查询结果，并不会自动过滤关联集合中的元素。即使你用INNER JOIN关联了ErrorLegalAct/ErrorAction，WHERE条件只会筛选出那些至少关联了一个active=true的子实体的ErrorType，但ErrorType对象中关联的集合仍然会加载所有符合映射关系的子实体（包括active=false的）。

下面是几种可行的解决方案：

1. 使用JOIN FETCH + ON条件（JPA 2.1+） #

通过JOIN FETCH显式加载关联集合，并在ON子句中添加子实体的active过滤条件，这样查询返回的ErrorType的关联集合只会包含active=true的条目。同时注意添加DISTINCT避免主实体重复（因为多表JOIN会导致主实体被多次返回）。

Criteria API示例代码：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<ErrorType> cq = cb.createQuery(ErrorType.class);
Root<ErrorType> root = cq.from(ErrorType.class);

// 处理ErrorLegalAct关联：JOIN FETCH + ON条件过滤active=true
Join<ErrorType, ErrorLegalAct> legalActJoin = root.join(ErrorType_.errorLegalActs, JoinType.INNER);
legalActJoin.on(cb.equal(legalActJoin.get(ErrorLegalAct_.active), Boolean.TRUE));
root.fetch(ErrorType_.errorLegalActs, JoinType.INNER).on(cb.equal(legalActJoin.get(ErrorLegalAct_.active), Boolean.TRUE));

// 处理ErrorAction关联：同理
Join<ErrorType, ErrorAction> actionJoin = root.join(ErrorType_.errorActions, JoinType.INNER);
actionJoin.on(cb.equal(actionJoin.get(ErrorAction_.active), Boolean.TRUE));
root.fetch(ErrorType_.errorActions, JoinType.INNER).on(cb.equal(actionJoin.get(ErrorAction_.active), Boolean.TRUE));

// 过滤主实体active=true
cq.where(cb.equal(root.get(ErrorType_.active), Boolean.TRUE));
// 去重避免主实体重复
cq.distinct(true);

List<ErrorType> result = entityManager.createQuery(cq).getResultList();

2. 使用@Filter注解实现全局过滤 #

如果你的业务场景中，所有查询ErrorLegalAct/ErrorAction时都需要过滤active=true的条目，可以通过JPA的@Filter注解全局配置：

1. 在子实体类上定义Filter：

@Entity
@Filter(name = "activeErrorLegalAct", condition = "active = true")
public class ErrorLegalAct {
    // 实体字段、关联映射...
}

@Entity
@Filter(name = "activeErrorAction", condition = "active = true")
public class ErrorAction {
    // 实体字段、关联映射...
}

2. 在ErrorType的关联字段上启用Filter：

@Entity
public class ErrorType {
    // 其他字段...
    
    @OneToMany(mappedBy = "errorType")
    @Filter(name = "activeErrorLegalAct")
    private List<ErrorLegalAct> errorLegalActs;
    
    @OneToMany(mappedBy = "errorType")
    @Filter(name = "activeErrorAction")
    private List<ErrorAction> errorActions;
}

3. 查询前启用Filter（需要Hibernate Session支持）：

entityManager.unwrap(Session.class)
             .enableFilter("activeErrorLegalAct")
             .enableFilter("activeErrorAction");

// 执行普通查询即可，关联集合会自动过滤active=true的条目
List<ErrorType> result = entityManager.createQuery("SELECT et FROM ErrorType et WHERE et.active = true", ErrorType.class)
                                      .getResultList();

3. 避免常见误区 #

不要将关联实体的active条件放在WHERE子句中——这种写法只会筛选出至少关联了一个active=true的子实体的ErrorType，但ErrorType的关联集合仍然会加载所有符合映射关系的子实体（包括active=false的），这就是你之前尝试后不符合预期的原因。

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