Spring Boot多Schema关联报错：@OneToOne引用未知实体schema2.Test2

API 探路者

2026-7-9

解决Hibernate @OneToOne关联跨Schema实体的Unknown Entity异常

问题根源

该异常是因为Hibernate无法识别com.models.schema2.Test2为合法实体，通常由实体配置缺失、扫描范围不足或跨Schema配置错误导致，以下是针对性解决方案：

修正Test2实体的基础配置
确保Test2类被标记为Hibernate实体，并明确指定所属schema：
```
@Entity
@Data
@Table(name = "Test2", schema = "schema2")
public class Test2 {
    @Id
    @Column(name = "id")
    private Integer id;
    // 其他业务字段
}
```
核心：必须添加@Entity注解，否则Hibernate不会将其纳入实体管理范畴。

确保跨包实体被扫描到

若使用Spring Boot，在启动类通过@EntityScan指定所有实体所在包：

@SpringBootApplication
@EntityScan(basePackages = {"com.models.schema1", "com.models.schema2"})
public class AppLauncher {
    public static void main(String[] args) {
        SpringApplication.run(AppLauncher.class, args);
    }
}

纯Hibernate环境，在hibernate.cfg.xml中显式注册Test2实体：

<hibernate-configuration>
    <session-factory>
        <!-- 其他配置 -->
        <mapping class="com.models.schema2.Test2"/>
    </session-factory>
</hibernate-configuration>

修正Test1中的关联注解细节
移除@JoinColumn中name属性的多余空格，并明确关联的schema与主键列：

@Entity
@Data
@Table(name = "Test1", schema = "schema1")
public class Test1 {
    @Id
    @Column(name = "id")
    private Integer id;

    @OneToOne
    @JoinColumn(
        name = "test2Column", // 去掉原代码末尾的空格
        referencedColumnName = "id",
        schema = "schema2" // 指定关联表所在schema
    )
    private Test2 test2Column;
}