Spring Boot JPA基于关联关系过滤嵌套实体数据问题

你的问题核心在于JPA实体关联的加载逻辑和SQL查询的作用范围不一致：你写的SQL只是过滤出了关联过指定eC的eA，但JPA加载eA实体后，会按照映射关系（而非查询的JOIN条件）去加载所有关联的eB和eC，所以返回的实体里包含了全部关联数据。

以下是几种可行的实现方式：

1. 使用JPQL FETCH JOIN 加载并过滤关联数据 #

这是最直接的方式，通过FETCH JOIN让JPA在查询eA的同时，只加载符合条件的eB和eC：

SELECT DISTINCT eA FROM EntityA eA
JOIN FETCH eA.eBs eB
JOIN FETCH eB.eCs eC
WHERE eC.id IN (1, 2, 3)

• 必须加DISTINCT：因为多表JOIN会产生笛卡尔积，导致eA重复出现，DISTINCT会让JPA合并重复的实体实例。
• 该查询会直接返回包含符合条件的嵌套eB、eC的eA实体，不会加载多余的关联数据。

2. 使用Criteria API 构建动态查询 #

如果需要动态调整过滤条件，用Criteria API更灵活：

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

// 关联并FETCH eB和符合条件的eC
Fetch<EntityA, EntityB> eBFetch = root.fetch("eBs", JoinType.INNER);
Fetch<EntityB, EntityC> eCFetch = eBFetch.fetch("eCs", JoinType.INNER);

// 添加过滤条件
query.where(eCFetch.get("id").in(1, 2, 3));
// 去重
query.distinct(true);

List<EntityA> result = entityManager.createQuery(query).getResultList();

3. 返回DTO而非实体（推荐用于复杂场景） #

如果不需要修改实体，只是展示数据，返回自定义DTO可以精确控制返回内容，避免JPA关联加载的干扰：
首先定义嵌套DTO：

public class CDto {
    private Long id;
    private String name;
    // 构造函数、getter方法
}

public class BDto {
    private Long id;
    private String name;
    private List<CDto> cList;
    // 构造函数、getter方法
}

public class ADto {
    private Long id;
    private String name;
    private List<BDto> bList;
    // 构造函数、getter方法
}

然后用JPQL投影查询并组装：

SELECT new com.yourpackage.ADto(eA.id, eA.name, eB.id, eB.name, eC.id, eC.name)
FROM EntityA eA
JOIN eA.eBs eB
JOIN eB.eCs eC
WHERE eC.id IN (1, 2, 3)

之后在业务层将查询结果分组组装成嵌套的DTO结构，或者使用Spring Data的Projection接口简化操作。

注意事项 #

• 不要依赖fetch = EAGER：EAGER加载会导致JPA总是加载全部关联数据，即使你用了过滤查询，建议改为LAZY，由查询主动控制加载哪些关联。
• 避免N+1查询：使用FETCH JOIN或DTO投影可以有效避免JPA加载关联时产生的额外SQL查询。

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