JPA+Hibernate项目运行报Unknown entity: entity.Student错误如何解决

java.lang.IllegalArgumentException: Unknown entity: entity.Student异常的本质是Hibernate未将entity.Student识别为合法的托管实体类，结合你提供的代码信息，可按以下顺序排查修复：

• 检查实体类注解正确性
  确认Student、Guide类满足实体类要求：
  1. 导入的@Entity注解为javax.persistence.Entity，未误导入org.hibernate.annotations.Entity
  2. 两个类都声明了带@Id注解的主键字段，缺少主键的类无法被识别为JPA实体
• 检查Hibernate配置文件加载逻辑
  1. 确认hibernate.cfg.xml存放在Maven项目的src/main/resources目录下，编译后会输出到classpath根目录
  2. 检查你的HibernateUtil类构建SessionFactory时调用了.configure()方法加载配置，参考标准写法：

  public class HibernateUtil {
      private static final SessionFactory sessionFactory = buildSessionFactory();
      private static SessionFactory buildSessionFactory() {
          try {
              // 加载classpath下的hibernate.cfg.xml配置
              return new Configuration().configure().buildSessionFactory();
          } catch (Throwable ex) {
              System.err.println("SessionFactory初始化失败: " + ex);
              throw new ExceptionInInitializerError(ex);
          }
      }
      public static SessionFactory getSessionFactory() {
          return sessionFactory;
      }
  }
  

  如果构建Configuration时没有调用.configure()，则不会读取hibernate.cfg.xml里的实体映射配置，导致实体未被注册。
• 排查依赖冲突
  确认项目中没有同时引入javax.persistence和jakarta.persistence两类JPA API依赖，Hibernate 5.5.6版本默认兼容javax.persistence注解，若误导入jakarta的注解会导致实体识别失败。

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