JPA一对多关联查询父实体时无法获取子实体求助

1. 解决循环引用导致的序列化/展示异常 #

你的实体类存在双向循环引用（Parent包含Child集合，Child包含Parent引用），而@Data和@ToString会自动生成包含所有字段的toString方法，这会触发循环调用，最终要么栈溢出，要么看起来子实体未加载（实际已加载，但序列化时无法正常展示）。

解决方法：
在Child类的parent字段上添加@ToString.Exclude，排除该字段生成到toString中：

@ManyToOne(cascade = CascadeType.ALL)
@JoinColumn(name = "parent_id", referencedColumnName = "id")
@ToString.Exclude // 新增注解
private Parent parent;

2. 修正LEFT JOIN FETCH的JPQL写法 #

如果自定义查询未生效，检查JPQL是否正确：
在ParentRepository中添加如下方法：

import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import java.util.List;

public interface ParentRepository extends CrudRepository<Parent, Long> {
    @Query("SELECT DISTINCT p FROM Parent p LEFT JOIN FETCH p.childs")
    List<Parent> findAllWithChilds();
}

• 使用DISTINCT是因为LEFT JOIN FETCH会生成重复的Parent实例（每个Child对应一个Parent副本），去重后得到正确的Parent集合
• 调用该方法替代默认的findAll()

3. 正确配置Entity Graph #

如果之前的Entity Graph未生效，按以下步骤调整：

步骤1：在Parent类上定义NamedEntityGraph #

@Entity
@Table(name = "Parent")
@NamedEntityGraph(
        name = "Parent.childs",
        attributeNodes = @NamedAttributeNode("childs")
)
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Parent {
    // ... 原有字段
}

步骤2：在Repository方法上指定使用该Entity Graph #

public interface ParentRepository extends JpaRepository<Parent, Long> {
    @Override
    @EntityGraph(value = "Parent.childs", type = EntityGraph.EntityGraphType.LOAD)
    List<Parent> findAll();
}

调用默认findAll()时，会强制加载关联的Child集合。

4. 其他排查点 #

• 数据库数据验证：确认Child表的parent_id字段已正确关联到Parent表的id，无空值或无效值
• 事务上下文：确保查询操作在事务内执行（比如在Service层方法上添加@Transactional注解），避免Hibernate Session提前关闭导致关联数据无法加载

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