Hibernate无法识别com.trykote.tg.database.dto包下TgGroupEntity实体问题

1. 同包同名类冲突（概率最高） #

检查以下位置是否存在和com.trykote.tg.database.dto.TgGroupEntity同包同名的类：

• src/test/java的同包路径下是否有同名测试类，若该类没有加@Entity注解，类加载时会优先加载测试路径下的类，导致Hibernate识别不到实体
• 项目依赖的第三方jar包中是否包含同包同名的类，导致类加载顺序异常，Hibernate拿到了无注解的类实例

该情况完全符合你换包就正常、改名仍报错的现象：换包后路径唯一不会冲突，改名后只要包路径不变还是会触发同名类加载优先级问题。

2. 关联类导包错误 #

检查VkGroupEntity中关联TgGroupEntity的字段的导包是否正确：
VkGroupEntity在com.trykote.tg.database.dto.group包下，若没有显式import com.trykote.tg.database.dto.TgGroupEntity，或者误导入了其他包下的同名类，会导致Hibernate处理关联时找不到对应的实体配置。

3. 编译缓存残留 #

IDE编译缓存或者构建目录残留旧的class文件：

• 执行mvn clean（或Gradle对应clean命令）删除整个target/build目录，重新编译后再运行测试，排查是否是旧的无注解class文件导致的识别异常。

4. 包路径过滤规则 #

检查项目配置中是否存在针对该包的类过滤规则：

• Maven/Gradle编译配置中是否有<exclude>规则刚好匹配到该类
• 项目中若有JPA扫描、组件扫描配置，是否有排除规则过滤了该类

5. 配置拼写校验 #

确认hibernate.cfg.xml中TgGroupEntity的全限定类名拼写完全正确，包括大小写、包路径层级，避免因为拼写误差导致Hibernate加载不到对应类。

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