SpringBoot JPA生成错误JPQL引发SQL异常及栈溢出问题

初始问题回顾 #

执行自定义本地查询tempQuery时，JPA自动生成第二条JPQL语句，使用了不存在的列名LADDERENTITYTEMP_LADDER_SEQUENCE_ID，引发org.hibernate.exception.SQLGrammarException（ORA-00904无效标识符）；调整映射配置改用JPQL后又出现StackOverflowError。

1. 初始代码中的问题 #

• 双向关联重复维护外键：RungEntityTemp中同时存在ladderSequenceId字段和@ManyToOne关联的ladderEntityTemp，未明确关联关系，导致Hibernate无法正确识别外键列。
• EAGER加载强制关联查询：@OneToMany设置了FetchType.EAGER，本地查询返回LadderEntityTemp后，Hibernate会自动触发关联查询加载ladderRungs，但映射配置混乱导致查询出错。
• 冗余注解干扰：RungEntityTemp的@Column注解中多余的table = ""属性，可能影响Hibernate的映射解析逻辑。

2. JPA生成错误列名LADDERENTITYTEMP_LADDER_SEQUENCE_ID的原因 #

初始代码中RungEntityTemp的@ManyToOne未添加@JoinColumn指定外键列，Hibernate默认采用关联实体类名_主键列名的规则生成隐式外键列名（转成大写后为LADDERENTITYTEMP_LADDER_SEQUENCE_ID），但数据库实际的外键列是LADDER_SEQUENCE_ID，因此触发无效标识符错误。

3. 阻止JPA执行自动生成的关联查询的方法 #

• 修改关联加载策略：将@OneToMany的fetch属性改为FetchType.LAZY，默认不会自动加载关联的ladderRungs，仅当主动调用该属性时才触发查询。
• 使用DTO投影：如果不需要返回完整实体，可定义DTO类，通过JPQL查询仅返回所需字段，避免Hibernate加载关联实体。
• 明确控制关联查询：若需按需加载关联数据，可在JPQL中使用join fetch明确指定要加载的关联对象，避免自动触发额外查询。
• 清理映射配置：确保双向关联的mappedBy和@JoinColumn配置正确，让Hibernate能正确识别外键列，避免生成错误查询。

4. 是否与JPA版本（SpringBoot 3.0.8依赖jakarta.persistence-api 3.0.1）有关？ #

无关。该问题完全由实体映射配置错误导致，Jakarta Persistence 3.x仅为API层面的升级，核心的Hibernate映射规则与JPA 2.x一致，这类配置问题在任何JPA版本中都会出现。

修改后StackOverflowError的解决方法 #

修改后的代码出现栈溢出，是因为@Data注解自动生成的toString方法包含了双向关联对象：LadderEntityTemp的toString会调用RungEntityTemp的toString，而RungEntityTemp的toString又会调用LadderEntityTemp的toString，形成循环调用。

解决方式：

• 在RungEntityTemp上添加@ToString(exclude = "ladderEntityTemp")，排除关联的父实体字段。
• 或在LadderEntityTemp上添加@ToString(exclude = "ladderRungs")，排除关联的子实体列表字段。

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