Spring Boot中如何仅加载Student实体而不关联Subject集合？

问题场景 #

现有Student和Subject两个实体，为一对多关联（一个学生对应多个科目），实体代码如下：

Student实体代码 #

@Getter @Setter
@Entity
public class Student{
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    private Long id_student;

    private String name;

    @OneToMany(fetch = FetchType.LAZY, mappedBy = "student", cascade = CascadeType.ALL)
    private List<Subject> subject;
    // 构造方法省略
}

Subject实体代码 #

@Getter @Setter
@Entity
public class Subject{
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    private Long id_subject;

    private String name_subject;
    @ManyToOne(fetch=FetchType.LAZY)
    @JoinColumn(name = "id_student", referencedColumnName = "id_student", nullable = false)
    @JsonIgnore
    private Student student;
    // 构造方法省略
}

当前通过Controller调用JpaRepository的findById方法查询Student时，无论设置FetchType.LAZY还是EAGER，都会加载关联的Subject集合。需求是仅加载Student实体，不想手动编写Getter/Setter排除Subject或使用DTO（认为会浪费资源），同时想了解懒加载的工作机制，求可行解决方案。

懒加载工作机制 #

JPA的懒加载（FetchType.LAZY）核心是延迟加载关联对象：只有当你主动调用关联对象的方法（比如student.getSubject().size()）时，Hibernate才会触发额外SQL查询加载关联数据。但有个关键前提：必须在持久化上下文（EntityManager）打开的情况下调用，如果上下文已经关闭，会抛出LazyInitializationException。

你遇到的懒加载失效，大概率是因为JSON序列化触发了懒加载：Controller返回Student对象时，JSON序列化框架（比如Jackson）会遍历对象的所有Getter方法，调用getSubject()，如果此时持久化上下文还没关闭（比如默认开启的Open Session in View模式），就会触发SQL查询加载Subject集合。

可行解决方案 #

1. 用Jackson忽略懒加载代理属性 #

直接在Student的subject字段上添加@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})，Jackson序列化时会跳过懒加载代理的内部属性，不会触发关联数据的加载：

@OneToMany(fetch = FetchType.LAZY, mappedBy = "student", cascade = CascadeType.ALL)
@JsonIgnoreProperties({"hibernateLazyInitializer", "handler"})
private List<Subject> subject;

这种方式无需修改其他配置，简单直接。

2. 使用JPA实体图（从查询层面控制加载） #

通过实体图明确指定查询时只加载Student的基本属性，不加载关联的Subject集合，从根源避免关联数据被加载。

方式一：动态指定加载属性

在Repository方法上直接配置实体图：

public interface StudentRepository extends JpaRepository<Student, Long> {
    @EntityGraph(attributePaths = {"name"}, type = EntityGraph.EntityGraphType.FETCH)
    Optional<Student> findById(Long id);
}

方式二：定义命名实体图

先在Student实体上定义命名实体图：

@Entity
@NamedEntityGraph(name = "Student.onlyBasic", attributeNodes = @NamedAttributeNode("name"))
public class Student{
    // ... 其他代码
}

然后在Repository中引用：

public interface StudentRepository extends JpaRepository<Student, Long> {
    @EntityGraph(value = "Student.onlyBasic", type = EntityGraph.EntityGraphType.FETCH)
    Optional<Student> findById(Long id);
}

3. 关闭Open Session in View（OSIV）+ 配置Jackson忽略空Bean #

很多Spring Boot项目默认开启OSIV，它会让EntityManager在整个请求周期保持打开状态，导致序列化时能触发懒加载。关闭OSIV后，再配置Jackson忽略未初始化的懒加载集合：

在application.properties中添加：

spring.jpa.open-in-view=false

添加Jackson配置类：

@Configuration
public class JacksonConfig {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
        return builder -> builder.featuresToDisable(SerializationFeature.FAIL_ON_EMPTY_BEANS)
                .modules(new Hibernate5Module());
    }
}

注意需要引入jackson-datatype-hibernate5依赖，它能识别Hibernate懒加载代理，跳过未初始化的关联对象序列化。

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