Spring Boot 3.1.0中JPA FetchType.EAGER未预加载关联数据问题

可能的原因及对应解决方法 #

1. Kotlin Data Class属性缺少默认值 #

JPA要求实体类能被无参构造实例化，你的SubUser类中modules属性未设置默认值，导致Kotlin生成的data class无法提供JPA所需的构造逻辑，进而影响关联集合的初始化加载。

解决方法：
给modules添加默认空集合：

@Entity
@Table(name = "sub_users")
data class SubUser(

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null,

    @OneToMany(
        cascade = [CascadeType.ALL],
        orphanRemoval = true,
        fetch = FetchType.EAGER,
        mappedBy = "subUser"
    )
    val modules: Set<Module> = emptySet(), // 补充默认值
)

2. OneToMany反向关联的EAGER加载特性限制 #

在mappedBy标记的反向OneToMany关联中，部分JPA实现（如Hibernate）不会自动通过JOIN方式加载关联集合，即使标注了FetchType.EAGER，也可能因会话生命周期问题导致关联数据未加载。

解决方法：
在仓库接口中定义带JOIN FETCH的自定义查询，强制加载关联集合：

interface SubUserRepo : JpaRepository<SubUser, Long> {
    @Query("SELECT su FROM SubUser su JOIN FETCH su.modules WHERE su.id = :id")
    fun findByIdWithModules(@Param("id") id: Long): SubUser?
}

之后调用该方法替代findByIdOrNull()，即可确保modules被同时加载。

3. 事务上下文缺失 #

若查询操作不在事务范围内，Hibernate会话会在主实体查询后立即关闭，即使设置了EAGER加载，也无法完成关联数据的后续加载。

解决方法：
给调用仓库查询的业务方法添加@Transactional注解，维持会话生命周期：

@Service
class SubUserService(private val subUserRepo: SubUserRepo) {

    @Transactional
    fun getSubUser(id: Long): SubUser? {
        return subUserRepo.findByIdOrNull(id)
    }
}

验证建议 #

1. 确认数据库中sub_users与modules表的外键关联正确，且存在对应关联数据。
2. 查看应用SQL日志，检查是否有查询modules表的语句（EAGER加载应生成JOIN语句或额外的查询语句）。

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