Spring JPA OneToMany关联下父实体子集合始终为空的问题

核心原因 #

你遇到的问题本质是JPA双向关联的维护规则+一级缓存特性导致的：

1. @OneToMany(mappedBy = "parent")明确了Child是关联的维护端，Parent是被动端——仅在Child中设置parent属性并保存，只会更新数据库外键，但内存中Parent实例的children集合不会自动同步。
2. 事务内查询Parent时，默认会从Hibernate一级缓存获取最初保存的Parent实例（此时其children集合为空），不会主动从数据库拉取最新关联数据。

解决方案 #

方案1：手动维护双向关联的内存对象关系（推荐） #

在保存子实体时，同步更新父实体的子集合，确保内存中对象的关联关系完整。建议在父实体中封装关联维护方法，避免手动操作出错：

实体类优化

@Entity
class Parent {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null
    
    var name: String? = null
    
    @OneToMany(mappedBy = "parent", fetch = FetchType.LAZY, cascade = [CascadeType.ALL])
    val children: MutableList<Child> = mutableListOf()
    
    // 封装子实体添加逻辑，保证双向关联同步
    fun addChild(child: Child) {
        children.add(child)
        child.parent = this
    }
}

@Entity
class Child {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null
    
    var name: String? = null
    
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "parent_id")
    var parent: Parent? = null
}

业务代码实现

@Transactional
fun saveParentAndChild() {
    val parent = Parent(name = "测试父实体")
    val child = Child(name = "测试子实体")
    
    // 调用封装方法维护双向关联
    parent.addChild(child)
    
    // 因设置了CascadeType.ALL，保存父实体会自动保存关联的子实体
    parentRepository.save(parent)
    
    // 此时查询父实体，缓存中的实例已包含子集合
    val foundParent = parentRepository.findById(parent.id!!).get()
    // foundParent.children 可正常获取子实体列表
}

方案2：强制刷新缓存（仅临时调试用） #

如果不想修改对象关联逻辑，可以在保存子实体后，手动刷新EntityManager，清空一级缓存后重新查询：

@Autowired
private lateinit var entityManager: EntityManager

@Transactional
fun saveAndRefresh() {
    val parent = Parent(name = "测试父实体")
    parentRepository.save(parent)
    
    val child = Child(name = "测试子实体", parent = parent)
    childRepository.save(child)
    
    // 刷新EntityManager，同步缓存与数据库状态
    entityManager.flush()
    entityManager.clear()
    
    // 重新查询会从数据库拉取最新数据
    val foundParent = parentRepository.findById(parent.id!!).get()
    // 触发LAZY加载：访问集合元素即可
    foundParent.children.size
}

方案3：使用JOIN FETCH强制加载关联集合 #

在Repository中定义查询时，通过JOIN FETCH强制EAGER加载子集合，绕过LAZY加载和缓存问题：

interface ParentRepository : JpaRepository<Parent, Long> {
    @Query("SELECT p FROM Parent p JOIN FETCH p.children WHERE p.id = :id")
    fun findByIdWithChildren(@Param("id") id: Long): Parent?
}

调用该方法查询时，会直接加载关联的children集合，无需依赖LAZY加载触发。

关键注意事项 #

• 双向关联必须同时维护内存对象的双向关系，否则一级缓存中的实体不会自动更新关联集合
• mappedBy指定的维护端（Child）必须设置parent属性，否则数据库外键不会被正确写入
• CascadeType.ALL可简化保存操作，但需根据业务场景选择合适的级联策略（如避免不必要的删除级联）

内容的提问来源于stack exchange，提问作者Mr.Mountain