Spring Boot中@ManyToOne懒加载异常：无法查询关联实体

补充说明 #

• yEntity类中新增了一个Integer类型属性yEntity，映射数据库列id_y，用于引用同类型对象，但该属性与xEntity中的关联列同名，且不属于关联关系
• 调试查看xEntity的Hibernate代理对象时，会抛出以下异常：

  Method threw 'org.hibernate.exception.GenericJDBCException' exception. Cannot evaluate fr.gouv.isidor.importation.infra.database.entity.themes.ThemeGroupeEntity$HibernateProxy$eChsTNoK.toString()
  

核心问题 #

Spring Boot应用中遇到@ManyToOne懒加载异常：使用FetchType.LAZY时无法获取关联实体，抛出「指定ID的实体不存在」错误；切换为FetchType.EAGER后当前模块代码正常，但另一模块会出现相同异常。

实体定义 #

XEntity #

@Entity
@Table(name = "x")
public class xEntity{

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

    @Column(name = "nom", nullable = false)
    private String nom;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "id_y", referencedColumnName = "id", nullable = false)
    private yEntity yEntity;

    // Getters and setters
}

yEntity #

@Table(name = "y")
public class yEntity{

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "theme_groupe_id_generator_seq")
    @SequenceGenerator(name = "theme_groupe_id_generator_seq", sequenceName = "theme_groupe_id_seq", allocationSize = 1)
    @Column(name = "id", nullable = false)
    private Integer id;

    @OneToMany(mappedBy = "yEntity", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<xEntity> themes;

    @Column(name="id_y")
    private Integer yEntity;

    // Getters and setters
}

问题详情 #

• 使用FetchType.LAZY从xEntity访问yEntity时，抛出异常：

  Unable to find fr.gouv.isidor.importation.infra.database.entity.themes.ThemeGroupeEntity with id 4
  

• 已确认数据库中存在ID为4的对应实体
• 当前模块使用JPA原生findById(Integer id)查询xEntity时，EAGER模式正常、LAZY模式异常；另一模块使用findByName(String name)查询时，LAZY模式正常、EAGER模式异常

已尝试方案 #

• 在所有Repository方法上添加@Transactional注解，确保会话开启
• 使用Hibernate.initialize()强制初始化关联实体，无效
• 切换为FetchType.EAGER，当前模块正常但另一模块出现相同异常

解决方案建议 #

1. 重命名yEntity中的冲突属性 #

这是引发问题的核心原因：yEntity中同时存在关联属性yEntity（对应xEntity的@ManyToOne关联）和普通字段yEntity（Integer类型），Hibernate处理懒加载代理时会混淆这两个属性。

修改yEntity中的普通字段名称，例如改为parentYId，同步更新映射注解和getter/setter：

@Column(name="id_y")
private Integer parentYId;

// 对应的getter和setter
public Integer getParentYId() {
    return parentYId;
}

public void setParentYId(Integer parentYId) {
    this.parentYId = parentYId;
}

2. 严格控制懒加载的会话范围 #

即使添加了@Transactional，也要确保访问懒加载关联属性的代码在同一个事务会话内执行。例如避免在Controller查询实体后，在视图层或非事务方法中访问关联属性，这类场景会触发懒加载异常。

3. 自定义查询指定加载策略 #

避免全局切换FetchType，针对不同模块的查询需求，在Repository中定义带JOIN FETCH的自定义查询，精准控制关联加载：

// xEntityRepository中添加自定义查询
@Query("SELECT x FROM xEntity x JOIN FETCH x.yEntity WHERE x.id = :id")
Optional<xEntity> findByIdWithYEntity(@Param("id") Long id);

当前模块使用该方法获取包含关联实体的数据，另一模块保持LAZY模式，互不影响。

4. 排查Hibernate执行日志 #

开启Hibernate调试日志（在application.properties中设置logging.level.org.hibernate=DEBUG），查看懒加载时执行的SQL语句，确认是否存在字段或表查询错误，进一步定位问题。

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