Hibernate @SoftDelete与@ManyToOne(LAZY)冲突问题咨询

为什么软删除关联实体不能用懒加载？ #

Hibernate 6.4的@SoftDelete注解会自动为实体添加全局软删除过滤逻辑，确保查询时不会返回已标记删除的记录，但它和懒加载代理机制存在核心冲突：

• 懒加载代理创建时，Hibernate无法预先判断关联实体是否已被软删除。
• 当后续访问代理属性时，Hibernate需要额外执行软删除状态检查，但代理的设计逻辑是延迟数据库查询，这种附加过滤无法被代理机制正确处理。
• 为了避免出现代理指向已软删除实体的不一致情况，Hibernate强制要求关联@SoftDelete实体的@ManyToOne关联使用EAGER加载。

可行的解决方案 #

1. 改用EAGER加载（最简单方案） #

如果关联实体数据量不大或访问频率低，直接接受EAGER加载即可：

@ManyToOne(fetch = FetchType.EAGER)
private EntityB referencedEntityB;

2. 手动实现软删除过滤（保留懒加载） #

放弃@SoftDelete注解，改用@Where注解手动添加过滤条件，同时自行处理删除逻辑：

// 在EntityB上添加过滤注解
@Entity
@Where(clause = "is_deleted = false")
public class EntityB {
    @Column(name = "is_deleted")
    private boolean deleted;

    // 自定义软删除方法：更新标记字段而非物理删除
    public void softDelete() {
        this.deleted = true;
    }
}

// 在EntityA中继续使用LAZY加载
@ManyToOne(fetch = FetchType.LAZY)
private EntityB referencedEntityB;

注意：删除操作必须通过更新deleted字段实现，不能调用EntityManager.remove()，否则会触发物理删除。

3. 使用Hibernate过滤器（灵活但配置复杂） #

定义全局过滤器，会话启用后懒加载会自动应用软删除过滤：

// 在EntityB上定义过滤器
@FilterDef(name = "softDeleteFilter", parameters = @ParamDef(name = "isDeleted", type = Boolean.class))
@Filter(name = "softDeleteFilter", condition = "is_deleted = :isDeleted")
@Entity
public class EntityB {
    @Column(name = "is_deleted")
    private boolean deleted;
}

// 在会话中激活过滤器
Session session = entityManager.unwrap(Session.class);
session.enableFilter("softDeleteFilter").setParameter("isDeleted", false);

这种方式可保留懒加载并实现全局过滤，但需要在每次会话中手动启用过滤器（或通过拦截器自动激活）。

内容的提问来源于stack exchange，提问作者Samuel K.