Hibernate 6迁移泛型问题：CriteriaQuery查询抛出类型不匹配异常

将应用从Hibernate 5.4.30.Final迁移至Hibernate 6.1.6.Final（数据库为H2 2.1.214）时，使用CriteriaQuery查询泛型字段name的代码在Hibernate 5中可正常运行，但在Hibernate 6中抛出类型不匹配异常。

代码示例 #

CriteriaBuilder cb = eMgr.getCriteriaBuilder();
CriteriaQuery<String> cr = cb.createQuery(String.class);
Root<Person> person = cr.from(Person.class);
cr.select(person.<String> get("name"));
TypedQuery<String> query = eMgr.createQuery(cr);

异常信息 #

Converting org.hibernate.query.QueryTypeMismatchException to JPA PersistenceException : Specified result type [java.lang.String] did not match Query selection type [java.lang.Object] - multiple selections: use Tuple or array

实体类定义 #

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;

@Entity
public class GenericPerson<T>
{
    @Id
    @GeneratedValue(generator = "increment")
    private long id;
    private T name;

    public GenericPerson()  {   }
    public GenericPerson(T name)    { this.name = name;}

    public T getName() { return this.name; }
    public void setName(T name) {   this.name = name;   }

    public long getId() { return this.id;}
    public void setId(long id) { this.id = id; }
}

@Entity
public class Person extends GenericPerson<String>
{
    public Person() { }
    public Person(String name) {    super(name);    }
}

原因 #

Hibernate 6对泛型实体的元数据解析逻辑做了更严格的处理：

• Hibernate 5在处理继承泛型父类的实体时，会宽松地通过子类的泛型参数推断父类字段的实际类型（比如Person继承GenericPerson<String>，H5会认为name字段是String类型）。
• Hibernate 6默认情况下，会将泛型父类中的字段T name解析为Object类型，因为它没有自动关联子类的泛型参数绑定。此时你的CriteriaQuery<String>声明返回String，但查询选择的字段被识别为Object，类型不匹配，触发异常。

解决方法 #

方法1：显式转换字段类型 #

使用CriteriaBuilder.treat()方法显式指定字段的实际类型，让Hibernate正确识别返回类型：

CriteriaBuilder cb = eMgr.getCriteriaBuilder();
CriteriaQuery<String> cr = cb.createQuery(String.class);
Root<Person> person = cr.from(Person.class);
// 显式将name字段转换为String类型
cr.select(cb.treat(person.get("name"), String.class));
TypedQuery<String> query = eMgr.createQuery(cr);

方法2：使用类型安全的元模型 #

如果项目中使用了JPA元模型（Metamodel），可以直接引用类型安全的属性，避免字符串字段名带来的类型推断问题：

// 假设生成的元模型类为Person_和GenericPerson_
cr.select(person.get(GenericPerson_.name));

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