Hibernate报错：‘@OneToMany或@ManyToMany指向未映射类’与‘非托管类型’排查求助

看起来你遇到的这个随机报错问题确实挺棘手的，结合你提供的代码和描述，我整理了几个可能的原因和对应的解决方案：

一、修正包扫描配置，避免模糊匹配导致的类加载问题 #

你的启动类中最初使用了带通配符*的扫描路径，虽然去掉*后暂时正常，但随机报错可能还是和扫描范围的模糊性有关：

• 简化启动类注解：@SpringBootApplication已经包含了@ComponentScan的功能，无需单独声明，避免重复配置带来的冲突。
• 明确扫描路径：
  • 给@EnableJpaRepositories指定basePackages，确保Repository接口被正确扫描：

    @EnableJpaRepositories(basePackages = "com.stephenalexander.projects.moviecollection.repository")
    

  • 给@EntityScan指定实体类所在的精确包（比如实体都在entity子包下），甚至直接指定实体类，彻底避免路径匹配问题：

    @EntityScan(basePackageClasses = {Movie.class, Rating.class, Rater.class})
    

    这种方式比包路径更可靠，不会因为包结构调整或拼写错误导致扫描失败。

二、清理实体类中的冗余注解，减少配置歧义 #

你的实体类中有一些不必要的注解，可能会干扰Hibernate的映射逻辑：

• 移除targetEntity属性：在@OneToMany和@ManyToOne中，Spring可以通过泛型（比如List<Rating>）自动推断目标实体，无需手动指定targetEntity，冗余配置反而可能引发映射错误。
  比如把Rating类中的：

  @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL, targetEntity = Movie.class)
  

  改为：

  @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.ALL)
  

• 简化@Entity注解：@Entity(name = "Rating")中的name属性是JPQL查询时的别名，默认会使用类名，除非你有特殊需求，否则可以直接写成@Entity，避免名称混淆导致的映射问题。

三、排查随机报错的类加载竞争问题 #

启动时随机报错的现象，大概率和类加载顺序有关：

• 避免在配置类中提前注入Repository/Service：你的Config类中直接注入了MovieRepository、MovieService等组件，这可能导致Spring在初始化配置类时，实体类还未完成映射就被引用，触发未映射错误。建议把这些注入移到实际使用的地方（比如Controller或Service），或者使用@Lazy延迟加载：

  @Autowired @Lazy
  private MovieRepository movieRepository;
  

• 检查数据库DDL自动更新配置：切换为Spring自动更新表后，确保application.properties中的spring.jpa.hibernate.ddl-auto设置为update（而不是none或create），同时确认数据库连接配置正确，避免连接到错误的数据库实例导致表结构不匹配。

四、额外排查点 #

• 确认依赖版本兼容性：检查Spring Boot、Hibernate、Postgres驱动的版本是否兼容，版本不匹配也可能导致随机的映射错误。
• 清理IDE缓存：IntelliJ中偶尔会因为缓存问题导致类扫描异常，可以尝试通过File -> Invalidate Caches...清理缓存后重启IDE。

按照以上步骤调整后，应该能解决随机报错的问题，建议你逐步修改并测试，确保每一步的配置都正确生效。

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