Hibernate 5.6升级后User实体映射失败：QuerySyntaxException求助

1. 实体映射配置检查 #

• 确认hibernate.cfg.xml中是否正确声明User实体，包路径必须和类的实际路径完全一致：

  <!-- 正确的实体映射写法 -->
  <mapping class="com.your.package.User"/>
  

• 检查User类的注解：必须添加@Entity注解，若数据库表名为关键字（比如user），需通过@Table明确指定并转义：

  @Entity
  @Table(name = "`user`") // MySQL用反引号转义关键字，其他数据库可对应调整
  public class User {
      // 实体属性及注解
  }
  

2. HQL语法修正 #

• HQL查询的是实体类名而非数据库表名，严格区分大小写：
  错误写法：from user（使用数据库表名小写）
  正确写法：from User（匹配实体类的类名）
• 若实体类通过@Entity(name = "CustomUser")指定了别名，HQL必须使用该别名：

  @Entity(name = "CustomUser")
  public class User { ... }
  

  对应HQL：from CustomUser

3. 配置加载有效性验证 #

• 检查HibernateUtil是否正确加载配置文件，确保路径无误：

  Configuration configuration = new Configuration().configure("hibernate.cfg.xml");
  // 配置文件在resources根目录时无需额外路径，子目录需写完整相对路径
  

• 查看初始化日志，确认Hibernate启动时未出现配置文件解析失败、实体类找不到等前置错误。

4. 类路径与类加载排查 #

• 清理WAR包中重复的Hibernate依赖，确保仅保留Hibernate 5.6版本的jar包，避免类加载冲突。
• 确认User实体类已正确编译并打包到WEB-INF/classes目录下，无缺失或编译错误。

5. 全局关键字转义配置 #

• 若数据库表名包含关键字，可在hibernate.cfg.xml中开启全局标识符转义，避免映射冲突：

  <property name="hibernate.globally_quoted_identifiers">true</property>
  

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