Hibernate QuerySyntaxException求助：product实体未映射问题排查

我来帮你排查这个HQL的映射问题，你遇到的QuerySyntaxException本质是Hibernate找不到对应的实体映射，咱们一步步来解决：

1. 先确认HQL语句的核心规则 #

你已经尝试把from product改成from Product，这是正确的方向——HQL是面向实体类的查询语言，必须使用Java实体类的类名（注意大小写，Java类名首字母大写），而不是数据库表名。但改完还是报错，说明还有其他配置问题。

2. 检查Product实体类的映射配置（关键！） #

Hibernate不知道你的Product类是数据库对应的实体，所以才会提示“not mapped”。你需要确保：

• 如果用注解方式映射：Product类必须加上@Entity注解（这是标记实体的核心注解），如果数据库表名和类名不一致，还要用@Table指定表名。示例：

  package kr.ac.hansung.cse.model;
  
  import javax.persistence.Entity;
  import javax.persistence.Id;
  import javax.persistence.Table;
  
  @Entity
  @Table(name = "product") // 如果数据库表名为product的话，和类名一致也可以省略这个注解
  public class Product {
      @Id // 必须标注主键字段
      private int id;
      // 其他字段、getter/setter...
  }
  

• 如果用XML映射文件：需要在hibernate.cfg.xml里添加实体映射配置：

  <mapping class="kr.ac.hansung.cse.model.Product"/>
  

• 另外，要确保Spring能扫描到这个实体类：如果是Spring Boot项目，需要在启动类上添加@EntityScan(basePackages = "kr.ac.hansung.cse.model")；如果是传统Spring项目，要在XML配置里添加组件扫描或者实体扫描的配置。

3. 修正代码里的类型错误 #

你第二个尝试的代码里有个明显的类型转换错误：(List<User>)强转成List<Product>，这会导致ClassCastException，应该改成(List<Product>)。另外，你的DAO类已经加了@Transactional注解，Spring会自动管理事务的提交和回滚，不需要手动调用session.getTransaction().commit()。

4. 修正后的getProducts方法 #

结合上面的修正，最终的方法应该是这样的：

@SuppressWarnings("unchecked")
public List<Product> getProducts() {
    Session session = sessionFactory.getCurrentSession();
    // 使用实体类名Product，而非表名product
    Query query = session.createQuery("from Product");
    List<Product> productList = query.list();
    return productList;
}

额外排查点 #

如果还是报错，可以检查：

• Product类的包路径是否正确，DAO里的导入语句import kr.ac.hansung.cse.model.Product是否正确
• Hibernate配置文件里是否开启了自动扫描实体的配置（比如hibernate.hbm2ddl.auto相关配置是否正常）

内容的提问来源于stack exchange，提问作者최윤동