使用@SoftDelete时如何实现懒加载？关联查询性能问题求助

问题的核心不是@SoftDelete本身强制触发立即加载，而是你同时使用了@NotFound和FetchType.LAZY——根据Hibernate的规则，在@ManyToOne/@OneToOne关联中这两个注解不能共存，会被强制设置为EAGER加载，进而导致递归加载所有父节点引发性能问题。

以下是具体的解决方法：

1. 移除@NotFound注解（优先方案） #

如果你的数据库数据是规范的（不存在指向已物理删除父节点的无效外键），直接移除@NotFound即可让FetchType.LAZY生效，同时保留@SoftDelete的功能：

修改后的实体类代码：

@Entity
@Data
@SoftDelete
public class OrgUnit {

    @Id
    @GeneratedValue
    private UUID id;

    private String name;

    @ManyToOne(fetch = FetchType.LAZY, optional = true)
    private OrgUnit parent;
}

@SoftDelete的软删除过滤逻辑会自动排除已标记为删除的父节点，当叶子节点的parent_id指向已软删除的父节点时，因为optional=true，该字段会返回null，完全不需要@NotFound来处理关联不存在的情况。

2. 处理数据库无效外键的替代方案 #

如果数据库中确实存在指向已物理删除父节点的无效外键，不能直接移除@NotFound，可以用以下方式替代：

• 自定义查询过滤：通过JPQL或Criteria查询手动控制关联加载，只返回有效父节点：

  @Query("SELECT ou FROM OrgUnit ou LEFT JOIN ou.parent p " +
         "WHERE ou.id = :id AND (p IS NULL OR p.deleted = false)")
  OrgUnit findValidOrgUnitById(@Param("id") UUID id);
  

• DTO投影：查询时只返回需要的字段，避免加载整个关联实体，从根本上杜绝递归加载：

  @Query("SELECT new com.example.dto.OrgUnitDTO(ou.id, ou.name, p.id) " +
         "FROM OrgUnit ou LEFT JOIN ou.parent p " +
         "WHERE ou.id = :id AND (p IS NULL OR p.deleted = false)")
  OrgUnitDTO findOrgUnitDTOById(@Param("id") UUID id);
  

3. 检查@SoftDelete的配置 #

如果你使用的是第三方软删除框架（如org.hibernate.annotations.SoftDelete或Spring Data扩展），可以查看框架文档，确认是否有配置项可以控制关联的加载策略，避免强制EAGER加载。

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