SpringBoot JPA Repository删除操作不生效问题咨询

问题根因 #

• Column实体的cards字段配置了FetchType.EAGER + CascadeType.ALL + orphanRemoval = true，测试逻辑中创建的Column、Card在同一持久化上下文内处于托管状态，Column的cards集合持有目标Card的引用。删除SQL执行后，JPA事务提交时同步托管状态，会检测到Column仍关联该Card，自动将已被SQL删除的Card重新持久化到数据库，表现为删除SQL打印但数据未删除。
• 自定义@Modifying删除方法默认不会自动刷新、清空持久化上下文，上下文中残留的托管关联实体状态会覆盖删除操作结果。
• 级联配置错误：Card实体关联Column的@ManyToOne上配置了CascadeType.REMOVE，会导致删除Card时级联删除所属Column，属于反向级联逻辑错误。

落地解决方案 #

1. 修正错误级联配置 #

移除Card侧ManyToOne关联上的REMOVE级联，避免删卡片连带删列：

@ManyToOne(cascade = [CascadeType.DETACH], fetch = FetchType.LAZY)
@field:JsonIgnore
val column: br.com.fisgar.crm.entities.Column,

注意：@ManyToOne属于子实体关联父实体的方向，永远不要配置REMOVE级联，否则会出现子实体删除触发父实体删除的严重逻辑错误。

2. 优化自定义删除方法的@Modifying配置 #

修改CardRepository中deleteById方法，添加自动刷新、清空持久化上下文参数，阻断托管实体对删除结果的覆盖：

@Repository
interface CardRepository : CrudRepository<Card, Long> {

    @Modifying(clearAutomatically = true, flushAutomatically = true)
    @Query("DELETE FROM Card c where c.id = :id")
    override fun deleteById(@Param("id") id: Long)

}

参数作用：

• flushAutomatically = true：执行删除前先将持久化上下文中所有待同步的变更刷入数据库，避免前置更新丢失
• clearAutomatically = true：执行删除后清空当前持久化上下文，避免旧的托管实体（如持有Card引用的Column实例）在事务提交时重新持久化已删除数据

3. （必做性能优化）修改Column侧cards集合的加载策略 #

将cards字段的EAGER加载改为LAZY，彻底避免查询Column时自动加载全量关联Card的性能问题：

@OneToMany(fetch = FetchType.LAZY, cascade = [CascadeType.ALL], orphanRemoval = true, mappedBy = "column")
val cards: MutableList<Card> = ArrayList()

说明：全局EAGER加载会导致任意查询Column的场景都会拉取该列下所有Card，单列关联2万条Card时会产生严重的内存和IO开销，业务需要查询列下卡片时单独写查询方法按需拉取即可。

验证注意事项 #

• 调用删除方法的Service层方法需添加@Transactional注解，保证删除操作在事务范围内执行
• 执行删除后如果当前业务逻辑还要操作数据库，需要重新查询关联实体，不要使用删除前持有的旧实体引用（持久化上下文已清空，旧引用为游离状态）

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