如何用JPQL实现JOIN FETCH集合且保留全部子实体的条件查询？

问题背景 #

给定实体类：

@Entity
@Data
public class Collection {

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

  private String createdBy;

  @OneToMany(mappedBy = "collection")
  private List<CollectionAccess> collectionAccesses;

}

@Entity
@Data
public class CollectionAccess {

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

  @ManyToOne
  @JoinColumn(
      foreignKey =
          @ForeignKey(
              value = ConstraintMode.PROVIDER_DEFAULT,
              name = "fk_collectionaccess_collection_collections_id"))
  private Collection collection;

  private Integer accessType;
  private LocalDateTime expirationAtUtc;
}

数据库现有数据：

select id, created_by from collection;
+----+------------+
| id | created_by |
+----+------------+
| 40 |   ABC123   |
+----+------------+

select * from collection_access;
+----+-------------+----------------------------+---------------+
| id | access_type | expiration_at_utc          | collection_id |
+----+-------------+----------------------------+---------------+
|  2 |           0 | 2011-12-03 03:15:30.000000 |            40 |
|  3 |           1 | 2011-12-03 03:15:30.000000 |            40 |
+----+-------------+----------------------------+---------------+

需求说明 #

需要通过JPQL查询满足以下条件的Collection实体：

• 实体id为40；
• 用JOIN FETCH关联collectionAccesses集合，避免N+1查询；
• 筛选条件：createdBy匹配指定值，或存在任意CollectionAccess满足accessType = 1且expirationAtUtc <= 当前时间；该条件仅用于筛选Collection，必须保留Collection下所有CollectionAccess子实体。

遇到的问题 #

尝试多种方案均有异常：

• 直接在LEFT JOIN FETCH后加条件：会过滤不符合条件的子实体，只返回部分CollectionAccess；
• 同时使用普通LEFT JOIN和LEFT JOIN FETCH：返回结果出现重复子实体；
• 子查询方式：触发Hibernate语法错误；
• 使用Exists子查询：虽满足条件，但生成两条SQL，担心性能问题。

解决方案 #

方案1：关联查询+DISTINCT消除重复 #

通过LEFT JOIN单独做条件判断，同时用LEFT JOIN FETCH加载完整子实体集合，最后用DISTINCT消除笛卡尔积导致的重复结果。JPQL语句如下：

SELECT DISTINCT c
FROM Collection c
LEFT JOIN FETCH c.collectionAccesses
LEFT JOIN c.collectionAccesses ca
WHERE c.id = :id
AND (c.createdBy = :createdBy 
     OR (ca.accessType = 1 AND ca.expirationAtUtc <= :currentTime))

说明：

• LEFT JOIN FETCH c.collectionAccesses负责加载所有子实体，不会过滤任何CollectionAccess；
• LEFT JOIN c.collectionAccesses ca仅用于判断子实体的条件，不影响加载的子实体集合；
• DISTINCT是必须的，JOIN操作会产生笛卡尔积，导致同一个Collection被多次返回，Hibernate会自动去重并合并子实体集合。

方案2：EXISTS子查询+JOIN FETCH #

如果担心关联查询的性能，可使用EXISTS子查询配合JOIN FETCH，虽生成两条SQL，但实际执行效率取决于数据库优化，JPQL语句如下：

SELECT DISTINCT c
FROM Collection c
LEFT JOIN FETCH c.collectionAccesses
WHERE c.id = :id
AND (c.createdBy = :createdBy 
     OR EXISTS (
         SELECT 1 FROM CollectionAccess ca
         WHERE ca.collection = c
         AND ca.accessType = 1 
         AND ca.expirationAtUtc <= :currentTime
     ))

说明：

• EXISTS子查询仅判断是否存在符合条件的子实体，不会影响JOIN FETCH加载的完整子实体集合；
• 同样需要DISTINCT消除笛卡尔积带来的重复。

关键注意点 #

• 禁止在JOIN FETCH后直接添加条件，否则会过滤掉不符合条件的子实体；
• DISTINCT是处理JOIN笛卡尔积重复的必要手段，Hibernate会正确识别并合并子实体集合；
• 两种方案的性能差异需结合实际数据量测试，EXISTS在子实体数量较多时可能更高效，关联查询在数据量较小时速度更快。

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