Spring Boot JPA 批量删除父实体子实体不删解决办法

在 Spring Boot JPA 中，对含多个 @OneToMany 关系（如 Child1 和 Child2）的 Parent 实体执行批量逐个删除时，可能出现部分子实体未被级联删除、触发外键约束异常的问题——根本原因在于 Hibernate 一级缓存与事务内状态管理冲突，而非映射配置错误。

在 Spring Boot JPA 中，对含多个 `@OneToMany` 关系（如 Child1 和 Child2）的 Parent 实体执行批量逐个删除时，可能出现部分子实体未被级联删除、触发外键约束异常的问题——根本原因在于 Hibernate 一级缓存与事务内状态管理冲突，而非映射配置错误。

该问题的本质并非 @CascadeType.ALL 或 orphanRemoval = true 配置失效，而是 Hibernate 在单个事务中重复加载/操作同一 Session 时，因缓存与脏检查机制导致级联行为不一致。当您使用如下代码按 ID 逐个删除：

parentIds.stream().forEach(id -> parentRepository.findById(id)
    .ifPresent(parent -> parentRepository.delete(parent)));

尽管每个 parentRepository.delete(parent) 理论上应触发完整级联（Parent → Child1 或 Parent → Child2），但实际执行中：

• 第一次 findById() 加载 Parent A（关联 Child1）并删除 → Hibernate 正确级联删除 Child1 和 Parent A；
• 第二次 findById() 加载 Parent B（关联 Child2），但在同一 @Transactional 方法内，若此前操作已间接影响 Session 状态（例如延迟加载触发、缓存未刷新、或数据库隔离级别下读取到“旧快照”），Hibernate 可能未能正确识别 Child2 的存在，或在 flush 阶段以错误顺序执行 SQL（先删 Parent 后删 Child2），从而违反外键约束。

✅ 正确解决方案：避免在单次事务中混合多次 findById() + delete()

推荐采用以下任一方式（均需确保方法标注 @Transactional）：

方案一：使用 JPQL 批量删除（推荐，高效且规避实体加载）
直接通过 JPQL 删除父子记录，绕过实体生命周期管理：

@Repository
public class ParentRepositoryCustomImpl implements ParentRepositoryCustom {

    @PersistenceContext
    private EntityManager entityManager;

    @Override
    @Transactional
    public void deleteParentsAndChildrenByIds(List<Long> parentIds) {
        // 先删 Child1
        entityManager.createQuery(
                "DELETE FROM Child1 c WHERE c.parent.id IN :ids")
            .setParameter("ids", parentIds)
            .executeUpdate();

        // 再删 Child2
        entityManager.createQuery(
                "DELETE FROM Child2 c WHERE c.parent.id IN :ids")
            .setParameter("ids", parentIds)
            .executeUpdate();

        // 最后删 Parent
        entityManager.createQuery(
                "DELETE FROM Parent p WHERE p.id IN :ids")
            .setParameter("ids", parentIds)
            .executeUpdate();
    }
}

方案二：显式清除一级缓存（适用于必须用实体操作的场景）
在每次 delete() 后调用 entityManager.clear()，强制清空 Session 缓存，确保下次 findById() 获取干净状态：

@Transactional
public void deleteParentsOneByOne(List<Long> parentIds) {
    for (Long id : parentIds) {
        Parent parent = parentRepository.findById(id)
            .orElseThrow(() -> new EntityNotFoundException("Parent not found: " + id));
        parentRepository.delete(parent);
        entityManager.flush();     // 强制同步到 DB
        entityManager.clear();     // 清除缓存，重置 Session 状态
    }
}

⚠️ 关键注意事项：

• @Transactional 必须作用于服务层方法（而非 Repository 层），且传播行为为 REQUIRED（默认）；
• 不要依赖 saveAll() / deleteAll() 对 List<Parent> 操作——JPA 默认不会为集合元素自动触发级联删除，除非明确启用（需 @Modifying + JPQL 或自定义逻辑）；
• 数据一致性前提：确保数据库中每个 Parent 确实只关联 Child1 或 Child2（不能同时存在），且外键字段 parent_functional_id 值准确指向对应 Parent 主键；
• 若使用二级缓存（如 Ehcache），需额外配置缓存失效策略，但本问题通常仅涉及一级缓存。

总结：此问题不是 JPA 映射缺陷，而是事务边界与 Hibernate Session 生命周期协同不当所致。优先选用 JPQL 批量删除（方案一） —— 它语义清晰、性能优异、完全规避缓存干扰，是生产环境处理此类一对多级联删除的首选实践。