Hibernate注解映射实体报错：table is not mapped（已映射）求助

嘿，作为曾经踩过Hibernate无数坑的过来人，我太懂你现在的困惑了！明明已经加了映射注解，却还是报这个错，咱们一步步来排查可能的问题：

最常见的原因：HQL用了数据库表名而非实体类名 #

HQL是面向实体类的查询语言，不是直接写数据库表名！你的实体类叫StudentLogin，但如果你的查询语句里写的是数据库表名studentdetails，那肯定会报错。

举个例子：

• ❌ 错误写法：

  from studentdetails where username = ?
  

• ✅ 正确写法：

  from StudentLogin where username = ?
  

  或者用别名更规范：

  select s from StudentLogin s where s.username = ?
  

实体类未被Hibernate扫描到 #

即使你加了@Entity注解，如果Hibernate没扫描到这个类，也会认为表未映射：

• 如果是传统Hibernate配置（hibernate.cfg.xml），要确保里面添加了实体类的映射：

  <mapping class="com.rasvek.smartpos.beans.StudentLogin"/>
  

• 如果是Spring/Spring Boot环境：
  • 确认实体类所在的包com.rasvek.smartpos.beans在Spring的扫描路径下；
  • 如果实体类包和启动类不在同级/子级，要在启动类上添加@EntityScan("com.rasvek.smartpos.beans")注解指定扫描路径。

检查注解和表名的匹配细节 #

虽然你已经加了@Table(name="studentdetails")，但还是要确认：

• 数据库表名和注解里的name值完全一致（注意大小写！比如Oracle数据库表名是区分大小写的，MySQL默认不区分，但如果创建表时加了引号也要对应）；
• 确保@Entity注解没有写错（比如不小心写成了@Entitys这种拼写错误）。

排查查询语句的拼写错误 #

仔细检查你的HQL语句：

• 实体类名有没有拼写错误（比如把StudentLogin写成StudentLog）；
• HQL在部分环境下区分大小写，确保实体类名的大小写和代码里的类名完全一致。

小技巧：开启SQL日志辅助排查 #

可以在Hibernate配置里开启SQL日志，看看Hibernate实际生成的SQL是什么，更容易定位问题：

hibernate.show_sql=true
hibernate.format_sql=true

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