Spring Data JPA多租户：单实体关联多租户的实现方案咨询

一、原生多租户机制的扩展实现 #

Spring Data JPA的@TenantId注解默认仅支持单个租户ID匹配，直接返回租户ID列表不会生效，需要自定义拦截逻辑适配多租户IN查询：

1. 自定义SQL拦截器（Hibernate层面） #

实现Hibernate的EmptyInterceptor，在SQL预处理阶段自动注入多租户过滤条件：

public class MultiTenantInterceptor extends EmptyInterceptor {
    @Override
    public String onPrepareStatement(String sql) {
        List<String> currentTenantIds = TenantContext.getCurrentTenantIds();
        if (!currentTenantIds.isEmpty() && sql.contains("FROM entity_table")) {
            // 替换原单租户条件为IN查询
            String placeholders = String.join(",", Collections.nCopies(currentTenantIds.size(), "?"));
            return sql.replace("WHERE tenant_id = ?", "WHERE tenant_id IN (" + placeholders + ")");
        }
        return super.onPrepareStatement(sql);
    }
}

在配置类中注册该拦截器，同时通过TenantContext维护当前用户的租户ID列表，查询时自动替换参数为列表值。

2. Spring Data JPA Specification全局过滤 #

为所有Repository添加默认的多租户过滤规则，避免重复编码：

public class MultiTenantSpecification<T> implements Specification<T> {
    @Override
    public Predicate toPredicate(Root<T> root, CriteriaQuery<?> query, CriteriaBuilder cb) {
        List<String> tenantIds = TenantContext.getCurrentTenantIds();
        if (tenantIds.isEmpty()) {
            return cb.conjunction();
        }
        return root.get("tenantId").in(tenantIds);
    }
}

让Repository接口继承JpaSpecificationExecutor，查询时自动应用该Specification实现多租户过滤。

二、替代设计模式（原生机制不适用时） #

如果扩展原生多租户成本过高，可采用以下设计模式：

1. 多对多关联表模式 #

创建实体与租户的中间关联表（如entity_tenant_rel），实体类通过@ManyToMany关联租户：

@Entity
public class SharedEntity {
    @Id
    private Long id;
    // 其他业务字段
    @ManyToMany
    @JoinTable(
        name = "entity_tenant_rel",
        joinColumns = @JoinColumn(name = "entity_id"),
        inverseJoinColumns = @JoinColumn(name = "tenant_id")
    )
    private Set<Tenant> tenants;
}

查询时通过关联表过滤：SELECT e FROM SharedEntity e JOIN e.tenants t WHERE t.id IN (:currentTenantIds)，实现多租户共享同一实体。

2. 权限组映射模式 #

引入"权限组"概念，将共享实体关联到权限组，租户加入对应权限组后即可访问：

• 创建PermissionGroup实体，包含组ID、名称等字段；
• 实体与权限组为多对一关联，租户与权限组为多对多关联；
• 查询时先获取当前租户所属的权限组，再过滤出关联这些组的实体。
  这种模式适合复杂共享场景，可灵活控制租户的访问范围。

3. 静态数据副本模式 #

对于不频繁修改的静态共享数据，可为每个需要访问的租户创建实体副本。但此方案维护成本高，仅适合数据变更极少的场景，不推荐用于动态业务数据。

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