Spring Data JPA默认findById获取多级ManyToOne关联属性失败问题

实体定义 #

@Entity
@Table(name = "cabin_layout")
@Getter
@Setter
@NoArgsConstructor
@ToString
public class CabinLayout {

  @Id
  @GeneratedValue(strategy = GenerationType.IDENTITY)
  private Long id;

  @JsonIgnore
  @NotNull
  @ManyToOne(optional = false)
  private MissionProfile missionProfile;

}

@Entity
@Table(name = "mission_profile")
@Getter
@Setter
@NoArgsConstructor
@ToString
public class MissionProfile {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY, orphanRemoval = true)
    @JoinColumn(name = "mission_profile_id")
    private Set<FlightRangeShare> flightRangeShares; 

    @JsonIgnore
    @NotNull
    @ManyToOne(optional = false)
    private AircraftSeries aircraftSeries;

}

@Entity
@Table(name = "aircraft_series")
@Getter
@Setter
@NoArgsConstructor
@ToString
public class AircraftSeries {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @NotNull
    @Column(unique = true)
    @Enumerated(EnumType.STRING)
    private AircraftSeriesEnum aircraftSeriesEnum;

}

问题现象 #

调用cabinLayoutRepository.findById()获取CabinLayout实例时，仅能加载一级关联的MissionProfile，但MissionProfile下的AircraftSeries属性始终为null。只有额外调用missionProfileRepository.findById()才能成功获取AircraftSeries。

已尝试以下方案均未解决：

• 为关联属性设置FetchType.EAGER
• 添加@Fetch(FetchMode.JOIN)注解
• 自定义JOIN FETCH查询
• 配置Hibernate的max_fetch_depth参数

当前临时通过投影作为规避方案，使用环境：Spring Boot 2.7.0、Java 11。

可行解决方案 #

1. 修正自定义JOIN FETCH查询 #

确保查询语句明确关联二级实体，示例Repository方法：

@Repository
public interface CabinLayoutRepository extends JpaRepository<CabinLayout, Long> {
    @Query("SELECT cl FROM CabinLayout cl " +
           "JOIN FETCH cl.missionProfile mp " +
           "JOIN FETCH mp.aircraftSeries " +
           "WHERE cl.id = :id")
    CabinLayout findByIdWithFullAssociations(@Param("id") Long id);
}

调用此方法替代默认findById()，实现一次性加载所有关联层级。

2. 确保事务边界覆盖属性访问 #

懒加载属性必须在事务内才能触发加载，确保访问missionProfile.aircraftSeries的代码处于@Transactional注解的方法中。

3. 排除ToString方法对懒加载的干扰 #

实体类的@ToString注解若包含未加载的关联属性，可能导致加载异常或失败。可修改注解排除关联属性：

@ToString(exclude = {"missionProfile"}) // CabinLayout类
@ToString(exclude = {"flightRangeShares", "aircraftSeries"}) // MissionProfile类

4. 使用实体图（EntityGraph） #

通过实体图明确指定需要加载的关联层级：
首先在CabinLayout实体上定义实体图：

@Entity
@Table(name = "cabin_layout")
@NamedEntityGraph(
    name = "CabinLayout.full",
    attributeNodes = {
        @NamedAttributeNode(value = "missionProfile", subgraph = "missionProfile.full")
    },
    subgraphs = {
        @NamedSubgraph(
            name = "missionProfile.full",
            attributeNodes = @NamedAttributeNode("aircraftSeries")
        )
    }
)
public class CabinLayout {
    // ... 原有实体代码
}

然后在Repository中关联该实体图：

@Repository
public interface CabinLayoutRepository extends JpaRepository<CabinLayout, Long> {
    @EntityGraph(value = "CabinLayout.full", type = EntityGraph.EntityGraphType.FETCH)
    CabinLayout findById(Long id);
}

5. 调整Hibernate max_fetch_depth配置 #

在application.properties中设置：

spring.jpa.properties.hibernate.max_fetch_depth=3

该参数控制EAGER关联的级联深度，默认值为1，设置为3可覆盖三级实体关联的EAGER加载（注意仅对非集合类型关联生效）。

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