JPQL多连接查询层级数据时顶层实例重复返回问题排查

核心问题分析 #

你遇到的重复顶层实例问题，根源有两个：

1. 查询返回结果结构的误解
   你的JPQL语句是select distinct s, s1, s2，返回的是包含三个实体的Object数组列表，而非单一的SomeTable实例列表。因为底层有10个s2实例，每个s2都会和同一个s、s1组成一行结果——虽然s和s1重复，但每行的数组因s2不同，distinct无法对整行去重，最终List里会有10个这样的数组。如果你的代码直接把这些数组当成s实例处理，就会看到10个重复的s引用。

2. Fetch Join引发的笛卡尔积重复
   即使你调整为只查询s，使用left join fetch加载关联层级时，SQL会生成笛卡尔积结果（1个s × 1个s1 × 10个s2 = 10行）。JPA会为每行结果映射对象，虽然EntityManager的一级缓存会保证s是同一个实例，但List中会多次添加这个实例的引用，最终出现10个重复项。

修复方案 #

如果你需要的是带有完整三层级关联的顶层s实例（即s包含对应的s1集合，s1包含对应的s2集合），请调整JPQL语句：

假设SomeTable实体中定义了一对多的关联字段（比如children，对应parentId）：

@OneToMany(mappedBy = "parentId")
private List<SomeTable> children;

修正后的JPQL：

select distinct s from SomeTable s
join RelatedTable rt on s.id = rt.someId and rt.id = :paramId
left join fetch s.children s1
left join fetch s1.children s2

关键调整点：

• 仅选择s实体，而非三个实体的组合
• 使用实体的关联字段（s.children）进行fetch join，而非直接关联parentId
• 保留distinct，JPA会根据实体ID自动对重复的s实例去重，最终List中只会有1个顶层s实例，且其关联的s1、s2都已加载完成。

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