多数据源下@OneToMany/@ManyToMany指向未映射类的AnnotationException求助

我之前在多数据源项目里踩过一模一样的坑，这个异常的核心原因基本都和Hibernate SessionFactory的实体扫描范围或者跨数据源的非法关联有关，咱们一步步来排查解决：

一、先明确核心限制：JPA关联只能在同一数据源内的实体间建立 #

Hibernate的@ManyToMany这类关联注解是基于同一个SessionFactory（也就是同一个数据源）的实体设计的。如果你的Entity1和Entity2分别被配置给了不同的数据源（不同的SessionFactory），当前SessionFactory找不到另一个实体的映射信息，就会抛出这个"未映射类"的异常。

分两种场景解决： #

场景1：两个实体应该属于同一个数据源

如果这两个实体本来就该共用同一个数据源，那你需要检查当前数据源的实体扫描配置，确保两个实体所在的包都被包含进去：

• 如果你用Spring Boot + 多数据源配置，每个数据源的配置类上要通过@EntityScan指定完整的扫描路径，比如：

  @Configuration
  @EntityScan(basePackages = {"basepackage.a", "basepackage.a.b"}) // 同时覆盖两个实体的包路径
  @EnableJpaRepositories(basePackages = "xxx")
  public class TargetDataSourceConfig {
      // 数据源、EntityManagerFactory、TransactionManager的配置代码
  }
  

• 如果你是手动配置Hibernate的SessionFactory，要确保packagesToScan属性包含两个实体所在的包：

  LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
  sessionFactory.setDataSource(targetDataSource);
  sessionFactory.setPackagesToScan("basepackage.a", "basepackage.a.b"); // 扫描两个包下的实体
  

场景2：两个实体确实属于不同的数据源

这种情况下，JPA的关联注解是无法直接使用的（跨SessionFactory的关联不被Hibernate支持），你需要手动处理关联逻辑：

• 把Entity1里的Set<Entity2>改成Set<Long>（假设Entity2的主键类型是Long），直接存储Entity2的ID集合；
• 当需要获取关联的Entity2数据时，通过对应数据源的Repository手动查询：

  // 在业务层手动关联数据
  Set<Long> entity2Ids = entity1.getEntity2Ids();
  Set<Entity2> entities2 = entity2Repository.findAllById(entity2Ids);
  

• 这种方式虽然需要手动管理关联关系，但能彻底避开跨数据源的JPA关联限制。

二、额外检查：代码中的小细节 #

看你给出的Entity2代码，@ManyToMany(mappedBy = "entit...")看起来是未写完的，正确的应该是mappedBy = "entities2"（对应Entity1里的属性名）。虽然这个拼写错误通常会报另一种异常，但也可能间接导致映射识别问题，建议先修正这个拼写。

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