Spring Data JPA Schema多租户下同实体跨Schema关联查询实现方法

算力阿峰

2026-9-26

方案1：直接使用原生SQL（推荐，实现成本最低）

你这个场景不需要强制改用JPQL，原生SQL是最直接的实现方式，只要在查询里显式指定common schema的表即可，默认租户schema下的表可以不用写schema前缀：

// 定义在你的UserRepository接口中
@Query(value = "select u.* from user u left join common.user u2 on u.common_id = u2.id where u.id = :userId", nativeQuery = true)
User queryUserWithCommonInfo(@Param("userId") Long userId);

如果查询结果需要返回两个表的字段，你可以用Spring Data JPA的Projection接口或者DTO来接收结果，不需要额外调整实体定义。

方案2：使用JPQL实现（适合跨schema查询频次高的场景）

如果想要用JPQL做类型安全的查询，你需要额外定义一个绑定common schema的独立实体，同时排除这个实体的多租户schema动态替换逻辑：

定义CommonUser实体，固定绑定common schema：

@Entity
@Table(name = "user", schema = "common")
// 可以加自定义注解比如@NoTenant，用于后续多租户拦截器识别排除
public class CommonUser {
    @Id
    private Long id;
    // 其余字段和原User实体保持一致
}

调整你的多租户解析逻辑，识别到实体带@NoTenant注解时，不动态替换schema，直接使用实体@Table注解上配置的固定schema。
写JPQL查询即可：

@Query("select u from User u left join CommonUser cu on u.commonId = cu.id where u.id = :userId")
User queryUserWithCommonInfo(@Param("userId") Long userId);