Hibernate实体类@Where注解在fetch关联查询时不生效如何解决

@Where注解默认仅作用于实体的直接查询场景，不会自动应用到关联join、fetch的查询逻辑中，可通过以下两种方案实现全场景软删除自动过滤：

方案1：使用@Filter过滤器（兼容Hibernate 5及以上所有版本） #

Hibernate的过滤器规则会自动作用于所有涉及该实体的查询，包括关联抓取场景：

1. 调整User实体的注解配置：

@Table(name="cms_user", schema="public")
@Where(clause = "deleted = false") // 保留原有注解兼容直接查询场景
@FilterDef(name = "softDeleteUserFilter", defaultCondition = "deleted = false")
@Filter(name = "softDeleteUserFilter")
public class User {
  // 原有实体逻辑
}

2. 全局启用过滤器避免每次查询手动开启：

• 如果你使用Spring Boot，直接在配置文件中添加：

  spring.jpa.properties.hibernate.session_factory.default_filters=softDeleteUserFilter
  

• 如果你使用原生Hibernate，可在SessionFactory初始化时配置全局默认启用该过滤器，或者每次获取Session后调用session.enableFilter("softDeleteUserFilter")。

方案2：使用Hibernate原生@SoftDelete注解（Hibernate 6+版本最优解） #

Hibernate 6开始官方内置了软删除支持，@SoftDelete注解会自动在所有涉及该实体的查询（包括直接查询、关联join、fetch抓取）中添加软删除过滤条件，不需要手动编写过滤规则：

@Table(name="cms_user", schema="public")
@SoftDelete // 若软删除字段名不是deleted，可通过column属性指定，比如@SoftDelete(column = @Column(name = "is_deleted"))
public class User {
  // 原有实体逻辑
}

如果需要临时查询包含已删除的用户数据，可在查询前调用session.setProperty("hibernate.soft_delete.enabled", false)临时关闭软删除过滤。

内容的提问来源于stack exchange，提问作者michal.jakubeczy