Spring Boot 3.2.0升级后HQL查询类型比较失败问题求助

问题概述 #

将Spring Boot从3.1.5升级到3.2.0后，多个仓库执行JPA查询时出现错误：Cannot compare left expression of type 'com.acme.domain.AbstractEntity' with right expression of type 'com.acme.domain.User'。问题根源是Hibernate似乎忽略了Identifiable接口的约束，无法通过AbstractEntity识别ID字段来完成关联匹配。

相关代码定义 #

实体类结构 #

public class Auditing<T extends AbstractEntity & Identifiable, E extends Enum<?>>
...
public class User extends AbstractEntity implements Identifiable<Long>
...
public class AuditEventUser extends Auditing<User, UserEventType>
...

注：Identifiable<T>是仅包含T getId()方法的接口

报错的查询语句 #

@Query("""
    SELECT MAX(h.eventInstant)
      FROM User u
      JOIN AuditEventUser a ON a.entity = u
      JOIN a.eventHistory h
     WHERE u.username = :username
       AND a.event = :event
    """)
Instant getUserEventInstant(@Param("username") String username, @Param("event") UserEventType event);

可行解决方案 #

1. 显式指定关联ID字段 #

修改查询语句，直接通过ID字段进行关联，绕过Hibernate的泛型类型推断问题：

@Query("""
    SELECT MAX(h.eventInstant)
      FROM User u
      JOIN AuditEventUser a ON a.entity.id = u.id
      JOIN a.eventHistory h
     WHERE u.username = :username
       AND a.event = :event
    """)
Instant getUserEventInstant(@Param("username") String username, @Param("event") UserEventType event);

2. 优化泛型约束定义 #

调整Auditing类的泛型参数，明确Identifiable的类型参数，帮助Hibernate正确识别实体的ID类型：

// 方式一：使用通配符明确ID存在
public class Auditing<T extends AbstractEntity & Identifiable<?>, E extends Enum<?>>
// 方式二：如果项目中ID类型统一为Long，直接指定具体类型
public class Auditing<T extends AbstractEntity & Identifiable<Long>, E extends Enum<?>>

3. 确保Hibernate版本适配 #

Spring Boot 3.2.0默认适配Hibernate 6.4.x版本，检查项目依赖是否存在版本冲突，可显式指定Hibernate版本：

<!-- Maven示例 -->
<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.4.4.Final</version>
</dependency>

4. 完善AbstractEntity的JPA映射 #

如果AbstractEntity仅通过Identifiable接口实现ID方法，需在父类中显式添加JPA注解映射ID字段，确保Hibernate能识别：

@MappedSuperclass
public abstract class AbstractEntity implements Identifiable<Long> {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Override
    public Long getId() {
        return id;
    }

    // 可选：添加setter方法或构建器
    public void setId(Long id) {
        this.id = id;
    }
}

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