从JEE javax迁移到Jakarta EE+Hibernate时出现ClassCastException问题

我将代码从JEE（javax）迁移到Jakarta EE后，原本正常运行的查询函数抛出了ClassCastException异常，相关代码和异常信息如下：

原函数定义（片段） #

public <T extends GenericInputTimesheet> List<T> findWhereItemToto(Class<T> entityClass, Integer value)

简化后的Jakarta JPA数据模型 #

@MappedSuperclass
public abstract class GenericInputTimesheet<T extends GenericTimesheetItem> implements Serializable {

    @Id
    private long id;
    @NotNull
    @ManyToOne
    private T item;
}

@MappedSuperclass
public class GenericTimesheetItem implements Serializable {

    @Id
    private long id;
    private Integer toto;
}

@Entity
public class InputTimesheetMandat extends GenericInputTimesheet<Mandat> {

}

@Entity
public class Mandat extends GenericTimesheetItem {

}

查询函数实现 #

public <T extends GenericInputTimesheet> List<T> findWhereItemToto(Class<T> entityClass, Integer value) {
    return entityManager.createQuery("Select e From " + entityClass.getSimpleName() + " e Where e.item.toto=:toto", entityClass)
            .setParameter("toto", value)
            .getResultList();
}

调用代码 #

public void displayToto(Integer value) {
    try {
        List<InputTimesheetMandat> inputs = pocService.findWhereItemToto(InputTimesheetMandat.class, value);
        System.out.println(inputs.size() + " InputTimesheetMandat Toto = " + value + " founds");
    } catch (Exception e) {
        System.err.println(e.getMessage());
    }
}

捕获到的异常 #

java.lang.ClassCastException: class
org.hibernate.metamodel.model.domain.internal.MappedSuperclassTypeImpl
cannot be cast to class
org.hibernate.metamodel.model.domain.EntityDomainType
(org.hibernate.metamodel.model.domain.internal.MappedSuperclassTypeImpl
and org.hibernate.metamodel.model.domain.EntityDomainType are in
unnamed module of loader 'org.hibernate@6.1.5.Final' @304f8087)

问题原因与修复方案 #

问题核心是泛型约束不严谨：GenericInputTimesheet是@MappedSuperclass（映射超类，非实体），而原函数的泛型参数T extends GenericInputTimesheet没有限制T必须是标注@Entity的实体类。Hibernate 6.x（Jakarta EE主流实现）对类型校验更严格，处理查询元数据时会把映射超类类型误判，导致类型转换异常。

具体修复步骤 #

1. 收紧泛型约束：
   修改函数定义，确保T是继承自GenericInputTimesheet的实体类：

   public <T extends GenericInputTimesheet<?>> List<T> findWhereItemToto(Class<T> entityClass, Integer value)
   

   这样能让Hibernate明确识别传入的entityClass是实体类型，避免映射超类的类型混淆。

2. 优化实体名称获取（可选）：
   直接用entityClass.getSimpleName()可能存在实体自定义名称的兼容问题，可通过JPA元模型获取可靠的实体名称，或者确保实体类简单名与JPQL中使用的实体名一致。

3. 泛型类型解析保障：
   若Hibernate仍无法解析泛型关联路径e.item.toto，可以升级到Hibernate最新稳定版（修复部分泛型解析bug），或者在实体类中显式指定关联类型（比如在InputTimesheetMandat中重新定义item字段并指定类型）。

修复后调用findWhereItemToto(InputTimesheetMandat.class, value)，Hibernate会正确识别实体类型，不再抛出类型转换异常。

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