Spring Boot JPA（Jakarta）多对多关联数据无法加载问题排查

从javax.persistence切换到jakarta.persistence后，通过JPA查询Teacher时无法加载关联的StudentTeacherRelation集合（进而无法获取学生数据），此前使用javax包时功能正常。核心原因是升级到Jakarta EE（对应Spring Boot 3+、Hibernate 6+）后，框架对关联加载、循环引用的处理逻辑发生变化，结合Lombok自动生成的方法，触发了加载失败的情况。

1. 修复Lombok循环引用问题 #

@Data注解会自动生成toString()、equals()和hashCode()方法，双向关联（Teacher→StudentTeacherRelation→Teacher）会导致循环调用这些方法，Hibernate加载实体时为避免栈溢出，可能中断关联数据加载，最终返回空集合。

修改方式：给关联集合添加@ToString.Exclude，排除在自动生成的toString()之外：

// Teacher类
@Data
@Entity
@Table(name = "TEACHERS")
public class Teacher {
    // ...其他字段
    
    @OneToMany(mappedBy = "teacher", fetch = FetchType.EAGER, cascade = CascadeType.ALL)
    @ToString.Exclude
    private Set<StudentTeacherRelation> students = new HashSet<>();
}

// Student类
@Data
@Entity
@Table(name = "STUDENTS")
public class Student {
    // ...其他字段
    
    @JsonIgnore
    @OneToMany(mappedBy = "student", fetch = FetchType.EAGER, cascade = CascadeType.ALL)
    @ToString.Exclude
    private Set<StudentTeacherRelation> teacher = new HashSet<>();
}

2. 强制使用JOIN策略加载关联数据 #

Hibernate 6对FetchType.EAGER的默认加载策略进行了调整，可能不再默认使用JOIN查询，而是采用SELECT查询（N+1查询），若会话提前关闭或存在事务管理问题，会导致关联数据无法加载。

修改方式：添加Hibernate的@Fetch(FetchMode.JOIN)注解，强制在查询Teacher时通过JOIN一次性加载关联数据：

import org.hibernate.annotations.Fetch;
import org.hibernate.annotations.FetchMode;

// Teacher类
@OneToMany(mappedBy = "teacher", fetch = FetchType.EAGER, cascade = CascadeType.ALL)
@Fetch(FetchMode.JOIN)
private Set<StudentTeacherRelation> students = new HashSet<>();

3. 修复JSON序列化循环引用问题 #

虽然你在StudentTeacherRelation的teacher字段上加了@JsonIgnore，但双向关联的JSON序列化仍可能触发循环检测，导致框架自动过滤关联集合。改用@JsonManagedReference和@JsonBackReference可更精准处理双向关联序列化：

// Teacher类
@OneToMany(mappedBy = "teacher", fetch = FetchType.EAGER, cascade = CascadeType.ALL)
@JsonManagedReference
private Set<StudentTeacherRelation> students = new HashSet<>();

// StudentTeacherRelation类
@ManyToOne(fetch = FetchType.EAGER)
@MapsId("teacher_id")
@JoinColumn(name = "teacher_id")
@JsonBackReference
private Teacher teacher;

4. 验证数据库数据与映射一致性 #

• 确认STUDENT_TEACHER表中存在对应的teacher_id和student_id关联记录；
• 检查实体类字段与数据库列的类型、名称是否完全匹配（比如teacher_id是UUID类型，数据库列需同为UUID）；
• 确保@MapsId指定的字段名与StudentTeacherKey中的字段名完全一致（当前代码匹配，需确认无大小写错误）。

1. 优先尝试方案1（Lombok排除），这是最常见的触发原因；
2. 若无效，添加方案2的JOIN加载策略；
3. 最后检查JSON序列化和数据库数据是否存在问题。

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