Spring Boot 2.7迁移至3.2时Hibernate泛型实体查询异常排查

在Hibernate 6.4.x中，对JPQL查询的属性解析与继承结构的校验比5.x版本更严格。你的场景中存在以下核心矛盾：

• 抽象父类FachparameterReference（标记为@Entity，采用JOINED继承）的fachCode属性被标注为@Transient，意味着该属性不会映射到数据库；
• 多个子类（如ZuordnungReference、FehlerReference）重写了fachCode并添加@Convert注解，各自在子类对应的数据库表中生成了该字段；
• 当你在父类对应的FachparameterRepository中定义findByFachcode方法时，Hibernate需要解析父类上的fachCode属性，但父类的该属性是@Transient（无数据库映射），而子类的fachCode属于子类特有字段，Hibernate 6无法在父类查询的上下文里确定要引用哪个子类的fachCode字段，因此抛出属性无法解析的异常。

1. 统一父类属性映射（推荐） #

将fachCode属性的映射逻辑移至抽象父类FachparameterReference，移除子类中的重写实现：

• 去掉父类fachCode getter上的@Transient注解，统一添加@Convert注解；
• 如果不同子类需要不同的转换器实现，可以在子类中使用@AttributeOverride覆盖父类的转换器配置：

  @Entity
  public class ZuordnungReference extends FachparameterReference {
      @AttributeOverride(name = "fachCode", column = @Column(name = "ZUORDNUNG_FACHCODE"), converter = ZuordnungFachCodeConverter.class)
      private String fachCode;
  
      // 其他子类逻辑
  }
  

  这种方式让父类拥有明确的fachCode映射，仓库的findByFachcode方法可以正常解析属性，同时支持子类自定义转换规则。

2. 限定查询的具体子类 #

如果必须保留子类各自的fachCode实现，需要在仓库方法中明确指定查询的子类：

• 使用Spring Data的派生查询，针对每个子类定义专属方法：

  public interface FachparameterRepository extends JpaRepository<FachparameterReference, Long> {
      List<ZuordnungReference> findZuordnungReferenceByFachcode(String fachCode);
      List<FehlerReference> findFehlerReferenceByFachcode(String fachCode);
  }
  

• 或者使用JPQL查询明确指定子类：

  @Query("SELECT f FROM ZuordnungReference f WHERE f.fachCode = :fachCode")
  List<ZuordnungReference> findZuordnungByFachcode(@Param("fachCode") String fachCode);
  

  这种方式的缺点是需要为每个子类编写重复的查询方法，维护成本较高。

3. 调整Hibernate多态查询策略 #

在抽象父类FachparameterReference上添加@Polymorphism注解，指定显式多态查询：

@Entity
@Inheritance(strategy = InheritanceType.JOINED)
@Polymorphism(type = PolymorphismType.EXPLICIT)
public abstract class FachparameterReference extends EntityBase {
    // 父类属性与逻辑
}

该注解会让Hibernate仅查询明确指定的子类，配合JPQL中的类型判断（如TYPE(f) = ZuordnungReference）可以实现针对子类属性的查询，但需要修改仓库的查询语句，确保明确指向子类的fachCode字段。

4. 临时恢复Hibernate 5查询行为（不推荐长期使用） #

Hibernate 6默认禁用了隐式多态查询（即查询父类时自动包含所有子类），如果需要临时兼容旧逻辑，可以在application.properties中添加配置：

spring.jpa.properties.hibernate.query.implicit_polymorphism=true

但这种方式仅能规避报错，无法从根本解决父类无fachCode映射的问题，不适合作为长期解决方案。

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