Spring Boot跨库实体关联报错：@OneToOne/@ManyToOne引用未知实体

问题背景 #

使用Spring Boot开发应用时，遇到跨数据库的实体关联问题：

• Flight实体托管在app1数据库，包含一个Aircraft类型的属性
• Aircraft实体定义在当前应用，但托管在app2数据库
• 两个数据库分别配置了独立的EntityManagerFactory和TransactionManager，各自扫描对应包下的实体
• 在FlightRepository中编写基于Aircraft.registration的查询时，抛出@ManyToOne references an unknown entity异常

报错原因 #

JPA/Hibernate的实体关联（@ManyToOne/@OneToMany等）仅支持**同一个EntityManagerFactory（即同一个数据源）**下的实体。你的app1EntityManager只扫描com.student.application.domain.app1包，无法识别属于app2库的Aircraft实体，因此关联注解失效，抛出未知实体异常。

解决方案 #

方案1：拆分查询，手动实现关联 #

放弃JPA的实体关联注解，分两步完成查询逻辑：

1. 修改FlightRepository，添加按destination和aircraftId查询的方法：

public interface FlightRepository extends JpaRepository<Flight, Long> {
    Flight findFirstByDestinationAndAircraftIdOrderByDateDesc(String destination, Long aircraftId);
}

2. 在业务代码中先查询Aircraft的ID，再查询对应的Flight：

// 从app2库查询对应registration的Aircraft
Aircraft targetAircraft = aircraftRepository.findByRegistration(registration);
Flight resultFlight = null;
if (targetAircraft != null) {
    // 用Aircraft的ID查询app1库中的Flight
    resultFlight = flightRepository.findFirstByDestinationAndAircraftIdOrderByDateDesc(destination, targetAircraft.getId());
    // 手动关联Flight和Aircraft（如果业务需要）
    resultFlight.setAircraft(targetAircraft);
}

方案2：使用原生SQL跨库查询（数据库需支持） #

如果你的数据库支持跨库访问（如MySQL、PostgreSQL等），可以直接用原生SQL实现联合查询：

以MySQL为例，修改FlightRepository：

public interface FlightRepository extends JpaRepository<Flight, Long> {
    @Query(value = "SELECT f.* FROM app1.flight f " +
                   "INNER JOIN app2.aircraft a ON f.aircraft_id = a.id " +
                   "WHERE f.destination = ?1 AND a.registration = ?2 " +
                   "ORDER BY f.date DESC LIMIT 1", 
           nativeQuery = true)
    Flight findFirstByDestinationAndAircraftRegistration(String destination, String registration);
}

注意：需要确保数据库账号拥有访问两个数据库的权限，且数据库本身支持跨库查询语法。

关键注意事项 #

• 不要尝试让单个EntityManagerFactory同时扫描两个数据库的实体包，这会导致实体绑定到错误的数据源，引发更多查询异常。
• 跨数据库的实体关联无法通过JPA标准注解实现，必须通过手动拆分查询或原生SQL的方式处理。

内容的提问来源于stack exchange，提问作者Mr. ATC