Spring Boot3迁移后Hibernate6.1.7无法解析父类抽象属性问题

迁移背景 #

从Spring Boot 2.1迁移至Spring Boot 3，同步将Hibernate升级至6.1.7.Final版本后，遇到JPQL查询兼容性问题。

实体类结构 #

采用JOINED继承策略，父类为抽象类，三个子类分别对应不同数据表，其中子类DClass的属性对应数据库列名与其他子类不同：

@Table(name = "a")
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.STRING)
@Inheritance(strategy = InheritanceType.JOINED)
public abstract class AClass {

    public abstract String getAttribute();

    public abstract void setAttribute(String attribute);

}

@Entity
@Table(name = "b")
@DiscriminatorValue("B")
@DiscriminatorOptions(force = true)
public class BClass extends AClass {

    @Column(name ="attribute")
    private String attribute;

    // other attributes ...

    public String getAttribute(){
        return this.attribute;
    }

    public void setAttribute(String attribute){
        this.attribute = attribute;
    }
}

@Entity
@Table(name = "c")
@DiscriminatorValue("C")
@DiscriminatorOptions(force = true)
public class CClass extends AClass {
     @Column(name = "attribute")
     private String attribute;

    // other attributes ...

    @Override
    public String getAttribute(){
        return this.attribute;
    }

    @Override
    public void setAttribute(String attribute){
        this.attribute = attribute;
    }
}

@Entity
@Table(name = "d")
@DiscriminatorValue("D")
@DiscriminatorOptions(force = true)
public class DClass extends AClass {
     @Column(name = "attributeA")
     private String attributeA; // 该属性对应数据库列名与其他子类不同

    // other attributes ...

    @Override
    public String getAttribute(){
        return this.attributeA;
    }

    @Override
    public void setAttribute(String attribute){
        this.attributeA = attribute;
    }
}

查询代码 #

通过父类Repository定义JPQL查询，根据attribute查询实体：

@Repository
public interface ARepository<T extends AClass> extends JpaRepository<T, Long>, JpaSpecificationExecutor<T> {

    @Query("SELECT a " +
            "FROM AClass a " +
            "WHERE a.attribute=:attribute"
    )
    T findByAttribute(@Param("attribute") String attribute);
   // 其他方法...
}

@Service
public class AClassService {
     @Autowired
     private ARepository<AClass> aRepository;

     AClass findByAttribute(String attribute){
        return aRepository.findByAttribute(attribute);
     }
}

抛出异常 #

org.springframework.dao.InvalidDataAccessApiUsageException:
org.hibernate.query.SemanticException: 
Could not resolve attribute 'attribute' of 'AClass' 
due to the attribute being declared in
multiple sub types: ['BClass', 'CClass'] at
org.springframework.orm.jpa.EntityManagerFactoryUtils.convertJpaAccessExceptionIfPossible(EntityManagerFactoryUtils.java:371)

问题原因与解决方案 #

原因分析 #

Hibernate 6.x对JPQL的语义检查大幅收紧。旧版本（如5.x）会隐式遍历子类，尝试匹配同名属性并自动生成兼容的查询逻辑；但Hibernate 6要求父类必须有明确的JPA属性映射，否则无法解析JPQL中父类的属性引用——由于AClass仅定义了抽象方法，未映射数据库列，且子类的attribute是各自独立的属性（DClass甚至对应不同列名），导致查询时出现歧义。

解决方案 #

方案1：修改JPQL，明确子类属性匹配

通过TYPE()函数判断实体类型，分别指定对应子类的属性列：

@Query("SELECT a " +
        "FROM AClass a " +
        "WHERE " +
        "   (TYPE(a) = BClass AND a.attribute = :attribute) OR " +
        "   (TYPE(a) = CClass AND a.attribute = :attribute) OR " +
        "   (TYPE(a) = DClass AND a.attributeA = :attribute)")
T findByAttribute(@Param("attribute") String attribute);

这种方式完全基于JPA标准，兼容性好，逻辑清晰。

方案2：父类使用@Formula统一属性映射

借助Hibernate扩展注解@Formula，在父类中定义一个虚拟属性，通过SQL逻辑映射到不同子类的列：

@Table(name = "a")
@DiscriminatorColumn(name = "type", discriminatorType = DiscriminatorType.STRING)
@Inheritance(strategy = InheritanceType.JOINED)
public abstract class AClass {

    @Formula("CASE type " +
             "WHEN 'B' THEN (SELECT b.attribute FROM b b WHERE b.id = id) " +
             "WHEN 'C' THEN (SELECT c.attribute FROM c c WHERE c.id = id) " +
             "WHEN 'D' THEN (SELECT d.attributeA FROM d d WHERE d.id = id) " +
             "END")
    public abstract String getAttribute();

    public abstract void setAttribute(String attribute);
}

修改后原JPQL查询无需调整，但注意@Formula是Hibernate专有注解，非JPA标准。

方案3：重构实体与数据库结构（可选）

如果允许调整数据库，可以在父类表a中添加attribute列，子类使用@AttributeOverride覆盖列名（DClass可指定attributeA），但这种方案需要修改数据库结构，仅适用于无数据迁移压力的场景。

内容的提问来源于stack exchange，提问作者César Castro Aroche