如何解决Hibernate AnnotationException异常：@OneToMany或@ManyToMany指向未映射类

嘿，这个问题我之前也碰到过！核心就是Hibernate在构建EntityManagerFactory时，没把Application2识别成合法的JPA实体——哪怕你已经加了@Entity注解。结合你已经排查过的点，给你几个靠谱的解决方向：

1. 确认实体扫描范围覆盖了Application2的包 #

不管你用原生JPA的persistence.xml还是Spring/Spring Boot配置，都得确保扫描路径包含Application2所在的包：

• 原生JPA（persistence.xml）：
  如果之前是手动指定实体类的，新增Application2后必须把它加入<class>标签，不然Hibernate不会自动扫描子包。比如：

  <persistence-unit name="yourPersistenceUnit">
      <class>a.b.c.Message</class>
      <class>a.b.c.Application1</class>
      <class>a.b.c.d.Application2</class> <!-- 必须新增这一行 -->
      <!-- 其他配置项 -->
  </persistence-unit>
  

  要是想自动扫描整个包下的实体，可以设置<exclude-unlisted-classes>false</exclude-unlisted-classes>，但得保证persistence-unit的默认扫描路径包含目标包。

• Spring/Spring Boot：
  检查@EntityScan注解的扫描范围有没有覆盖到a.b.c.d（或者你移动后的a.b.c）。比如：

  @SpringBootApplication
  @EntityScan(basePackages = {"a.b.c", "a.b.c.d"}) // 显式包含Application2的包
  public class YourApplication {
      // ...
  }
  

  虽然@EntityScan默认会递归扫描子包，但如果是多模块项目或者包结构特殊，显式指定更稳妥。

2. 检查Application2是否被正确编译到classpath #

有时候IDE缓存或者构建工具（Maven/Gradle）的编译问题，会导致新增的类没生成.class文件。你可以：

• 去项目编译输出目录（比如Maven的target/classes、Gradle的build/classes/java/main）找a/b/c/d/Application2.class
• 如果找不到，执行一次clean编译：
  • Maven：mvn clean compile
  • Gradle：gradle clean build
    之后再启动项目试试。

3. 确认BaseEntity的注解是否正确 #

所有实体都继承了BaseEntity，得确保它加了@MappedSuperclass注解——这个注解告诉Hibernate这是一个映射超类，子类的实体配置才会生效。虽然Application1正常，但万一你修改BaseEntity时不小心去掉了这个注解呢？检查一下准没错。

4. 排查是否有实体过滤规则 #

有些项目会用Hibernate的自定义配置排除某些实体，比如设置了hibernate.exclude_unlisted_classes=true但没把Application2加入列表，或者用了自定义扫描器过滤了这个类。去你的JPA配置文件里找找这类规则。

最后试个笨办法：清理IDE缓存并重启 #

有时候IDE的缓存会抽风，导致类加载异常。比如IntelliJ IDEA可以用File -> Invalidate Caches...，勾选清除缓存后重启IDE，再重新编译项目。

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