如何使用单个@Query编写JPQL删除实体及其关联实体 避免约束异常

核心逻辑为按「删除关联Dish → 删除关联Vote → 删除Restaurant」的顺序执行批量JPQL删除操作，需搭配Spring Data JPA的@Modifying、@Transactional注解使用。

代码示例 #

1. Repository层代码 #

import org.springframework.data.jpa.repository.Modifying;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.CrudRepository;
import org.springframework.data.repository.query.Param;
import org.springframework.transaction.annotation.Transactional;

public interface RestaurantRepository extends CrudRepository<Restaurant, Long> {

    // 第一步：删除指定餐厅关联的所有Dish
    @Modifying
    @Transactional
    @Query("DELETE FROM Dish d WHERE d.restaurant.id = :restaurantId")
    void deleteDishesByRestaurantId(@Param("restaurantId") Long restaurantId);

    // 第二步：删除指定餐厅关联的所有Vote
    @Modifying
    @Transactional
    @Query("DELETE FROM Vote v WHERE v.restaurant.id = :restaurantId")
    void deleteVotesByRestaurantId(@Param("restaurantId") Long restaurantId);

    // 第三步：删除餐厅本身
    @Modifying
    @Transactional
    @Query("DELETE FROM Restaurant r WHERE r.id = :restaurantId")
    void deleteRestaurantById(@Param("restaurantId") Long restaurantId);

    // 封装为统一调用方法
    default void deleteRestaurantCascade(Long restaurantId) {
        // 执行顺序不能调整，否则会触发外键约束异常
        deleteDishesByRestaurantId(restaurantId);
        deleteVotesByRestaurantId(restaurantId);
        deleteRestaurantById(restaurantId);
    }
}

注意事项 #

• 所有修改类的JPQL操作必须加@Modifying注解，否则Spring Data JPA会判定为查询操作抛出异常
• @Transactional可以放在Repository方法上，也可以上移到调用该方法的Service层，生产环境更推荐在Service层统一管理事务
• 该方案生成的SQL是3条批量删除语句，比默认级联删除的N+1条语句性能提升明显，完全避免外键约束冲突
• 若项目开启了JPA二级缓存，可对应添加@CacheEvict注解清理相关实体缓存，避免缓存脏数据

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