如何使用Hibernate Entity Graph仅加载一级懒加载集合？

首先咱们明确核心问题：你用EntityGraphUtils.fromAttributePaths("vehicles")定义的实体图本身只会加载Brand关联的Vehicle集合，并不会主动加载Vehicle的parts。之所以返回结果里包含了parts，大概率是序列化阶段触发了懒加载（比如Jackson在序列化Vehicle对象时访问了parts属性，此时Hibernate会话还未关闭，就自动执行了懒加载查询）。

下面给你几个可行的解决方案：

方案1：用Jackson注解控制序列化行为 #

如果你的应用是通过REST接口返回数据，最直接的方式是阻止Jackson访问Vehicle的parts属性：

• 在Vehicle类的parts字段上添加@JsonIgnore，序列化时会直接忽略该属性：

@Entity
public class Vehicle implements Serializable {
    @ManyToOne
    @JoinColumn(name = "brand_id")
    private Brand brand;

    @JsonIgnore // 添加该注解阻止序列化parts
    @OneToMany(mappedBy = "vehicle", fetch = FetchType.LAZY, cascade = CascadeType.ALL)
    private Set<VehiclePart> parts;
}

• 要是你只是不想在这个查询场景下序列化parts，其他场景需要保留，可以用@JsonView区分序列化视图：
  1. 定义视图类：

  public class Views {
      public static class Basic {}
      public static class Detailed extends Basic {}
  }
  

  2. 给实体属性标记对应视图：

  @Entity
  public class Brand implements Serializable {
      @JsonView(Views.Basic.class)
      @OneToMany(mappedBy = "brand", fetch = FetchType.LAZY, cascade = CascadeType.ALL)
      private Set<Vehicle> vehicles;
  }
  
  @Entity
  public class Vehicle implements Serializable {
      @JsonView(Views.Basic.class)
      @ManyToOne
      @JoinColumn(name = "brand_id")
      private Brand brand;
  
      @JsonView(Views.Detailed.class) // 仅Detailed视图序列化parts
      @OneToMany(mappedBy = "vehicle", fetch = FetchType.LAZY, cascade = CascadeType.ALL)
      private Set<VehiclePart> parts;
  }
  

  3. 在查询接口上指定使用Basic视图：

  @GetMapping("/brands")
  @JsonView(Views.Basic.class)
  public List<Brand> getBrands() {
      return brandsService.find();
  }
  

方案2：使用Spring Data Projection #

创建投影接口，只包含需要返回的属性，查询结果会被封装成投影对象，序列化时不会访问未定义的属性：

1. 定义Brand的投影接口：

public interface BrandProjection {
    Long getId(); // 假设Brand有id属性
    String getName(); // 假设Brand有name属性
    Set<VehicleProjection> getVehicles();

    interface VehicleProjection {
        Long getId();
        String getModel(); // 假设Vehicle有model属性
        // 不定义getParts()方法，避免触发懒加载
    }
}

2. 修改Repository方法返回投影类型：

public interface BrandsRepository extends EntityGraphJpaRepository<Brand, Long> {
    Page<BrandProjection> findAll(Pageable pageable, EntityGraph entityGraph);
}

3. 调整Service层代码：

@Service
public class BrandsService {
    public List<BrandProjection> find() {
        return repository.findAll(PageRequest.of(0, 10, Sort.by(Sort.Direction.ASC, "id")), 
                                EntityGraphUtils.fromAttributePaths("vehicles")).getContent();
    }
}

方案3：显式指定Entity Graph类型为FETCH（可选） #

虽然默认类型已经是FETCH，但显式指定可以避免意外的加载行为：

EntityGraph entityGraph = EntityGraphUtils.fromAttributePaths(EntityGraph.EntityGraphType.FETCH, "vehicles");

最后再确认下：你的实体图定义是正确的，它只会加载Brand的vehicles集合，不会主动加载parts。问题的核心是序列化阶段触发了懒加载，上面的方案都能有效解决这个问题。

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