Hibernate 6抛出UnknownEntityException：无法解析根实体问题求助

核心原因 #

报错org.hibernate.query.sqm.UnknownEntityException: Could not resolve root entity 'customers'的直接原因是HQL语句误用了数据库表名：HQL是面向实体类的查询语言，必须使用实体类名称，而非数据库表名。你的代码里写了FROM customers，但对应的实体类是QLKH_DTO，Hibernate无法识别这个不存在的实体名称。

修复方案 #

方案1：修改HQL语句（最简单直接） #

将listCustomers方法中的HQL语句替换为实体类名称：

public void listCustomers() {
    Session session = factory.openSession();
    try {
        // 替换为实体类名QLKH_DTO
        List customers = session.createQuery("FROM QLKH_DTO").list();
        for (Iterator iterator = customers.iterator(); iterator.hasNext();) {
            QLKH_DTO customer = (QLKH_DTO) iterator.next();
            System.out.print("ID " + customer.getCustomerID());
            System.out.print(" Password " + customer.getPassword());
            System.out.print(" Fullname " + customer.getFullname());
            System.out.println(" Address " + customer.getAddress());
            System.out.println(" City " + customer.getCity());
        }
    } catch (HibernateException e) {
        e.printStackTrace(); // 建议添加异常打印，方便后续排查问题
    } finally {
        session.close();
    }
}

方案2：给实体类指定别名（更直观） #

如果想保留FROM customers的写法，可以在@Entity注解中指定实体名称：

package DTO;

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

// 添加name属性指定实体别名
@Entity(name = "customers")
@Table(name = "customers", catalog = "market")
public class QLKH_DTO implements java.io.Serializable {
    // ... 实体内容保持不变
}

这样原来的HQL语句无需修改即可正常运行。

额外排查点 #

如果修复后仍报错，检查以下内容：

• 确认hibernate.cfg.xml中的<mapping class="DTO.QLKH_DTO" />路径完全正确，包名和类名无拼写错误
• 确保@Entity注解导入的是jakarta.persistence.Entity（Hibernate 6兼容Jakarta EE规范，此导入正确）
• 验证HibernateUtil能正确加载配置文件：configure()默认读取类路径下的hibernate.cfg.xml，确认文件放置位置正确

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