Spring Boot-Hibernate下如何禁止为实体或查询自动添加tenantId

针对你遇到的自定义JPQL查询中框架自动追加tenantId导致条件重复的问题，提供以下几种实用解决方案：

方案一：使用Hibernate查询提示禁用单查询的租户过滤 #

在JPQL语句末尾添加Hibernate专属的查询注释/*+ HIBERNATE_DISABLE_TENANT_FILTER */，即可让该查询绕过自动添加tenantId的逻辑。修改后的查询代码如下：

@Query("select p from Permission p where p.tenantId = :tenantId and p.username=:username /*+ HIBERNATE_DISABLE_TENANT_FILTER */")
List<Permission> findPermissionByTenantIdAndUsername(@Param("tenantId") Long tenantId, @Param("username") String username);

该方案仅作用于当前查询，不会影响其他业务，是最轻量化的解决方式（Hibernate 5.2及以上版本支持）。

方案二：通过EntityManager动态禁用租户过滤器 #

如果需要在业务逻辑中动态控制是否启用租户过滤，可以通过EntityManager获取Hibernate Session，手动禁用/启用租户过滤器：

// 获取Session
Session session = entityManager.unwrap(Session.class);
// 禁用租户过滤器（默认过滤器名称为"tenant"）
session.disableFilter("tenant");

// 执行你的查询
List<Permission> permissions = permissionRepository.findPermissionByTenantIdAndUsername(tenantId, username);

// 查询完成后重新启用过滤器，避免影响后续业务
session.enableFilter("tenant");

这种方式适合需要根据业务条件动态切换的场景，但要注意必须在操作完成后恢复过滤器状态，防止其他查询出现租户数据泄露。

方案三：实体级别全局禁用自动租户过滤（Hibernate 6.2+支持） #

如果所有针对Permission实体的查询都不需要自动添加tenantId，可以在实体中覆盖父类的@TenantId注解，设置include = TenantIdInclude.NEVER：

@Data
@Entity
@Table(name = "PERMISSION")
public class Permission extends BaseEntity {
    @Id
    @Column(name = "ID")
    private Long id;

    // 覆盖父类注解，全局禁用该实体的自动租户条件追加
    @Override
    @Column(name = "tenant_id")
    @TenantId(include = TenantIdInclude.NEVER)
    protected Long tenantId;

    // 其他字段...
}

注意该方案会对所有Permission的查询生效，仅适用于该实体不需要租户隔离的场景。

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