升级Hibernate至6.6.23后遇UnknownEntityException，为何5.6.5时正常

核心原因：Hibernate 5与6的实体解析机制差异 #

• Hibernate 5.6.x有宽松的实体识别逻辑：哪怕你没在配置文件里显式加载目标实体的映射，只要实体类本身在类路径（比如依赖模块的jar已引入）且标注了@Entity注解，Hibernate会自动扫描并隐式注册这些实体。甚至通过反射触发类加载时，Hibernate会动态完成实体注册，让HQL查询能正常识别。
• Hibernate 6.x收紧了实体解析规则：默认只处理显式配置的实体——包括配置文件里的<mapping>项、指定的扫描包，或者编程式注册的类。如果实体的映射文件不在你加载的3个配置文件里，也没配置扫描该实体所在的包，HQL解析时就会直接抛出UnknownEntityException，不再做隐式扫描兼容。

解决办法 #

1. 显式配置实体扫描
   在测试用例的Hibernate配置文件中，添加实体所在包的扫描配置：

   <!-- 开启类和hbm文件的自动检测 -->
   <property name="hibernate.archive.autodetection" value="class,hbm"/>
   <!-- 扫描目标实体所在的包 -->
   <mapping package="com.your.othermodule.entity"/>
   

   如果是用代码构建SessionFactory，直接注册实体或包：

   Configuration config = new Configuration();
   // 注册单个实体类
   config.addClass(TargetEntity.class);
   // 或者注册整个包
   config.addPackage("com.your.othermodule.entity");
   

2. 确保实体映射文件在测试类路径
   检查构建工具（Maven/Gradle）的测试配置，把依赖模块的.hbm.xml映射文件纳入测试阶段的类路径。比如Maven里可以通过testResource配置，或者确保依赖模块的资源被正确打包到测试环境。

3. 校验HQL实体名称
   Hibernate 6对HQL的语法校验更严格，确认HQL里的实体名称和实体类@Entity(name = "xxx")的配置完全一致，避免因名称不匹配导致的识别失败。

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