派生delete方法先更新非空字段引发删除失败问题

背景说明 #

业务对象与通知为一对多关系，每种业务对象对应独立数据表，所有通知共用一张表，通知表通过entity_id字段持有业务对象的外键。

相关代码 #

通知实体类 #

@Entity
@Table(name = "notification")
class NotificationEntity(

    @Column(name = "entity_id")
    val entityId: Long,

    @Column(name = "type_code")
    val typeCode: String,

    val message: String,
) {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null
}

送货单（业务对象示例） #

class DeliveryNote(...) {
    @OneToMany
    @JoinColumn(name = "entity_id")
    val notifications: List<NotificationEntity> = emptyList()
}

通知仓库接口 #

interface NotificationRepository: JpaRepository<NotificationEntity, Long> {

    ...
    fun deleteAllByEntityId(entityId: Long) // 执行失败
    fun deleteAllByEntityIdAndTypeCode(entityId: Long, typeCode: String) // 正常工作
    ...
}

问题现象 #

调用notificationRepository.deleteAllByEntityId(...)按entityId批量删除通知时操作失败，Hibernate未直接执行删除SQL，而是先执行将entity_id设为null的更新操作，触发数据库非空约束报错。

开启Hibernate详细日志后，观察到的SQL执行流程如下：

...
select ne1_0.id,ne1_0.entity_id,ne1_0.message,ne1_0.type_code from notification ne1_0 where ne1_0.entity_id=?
...
update notification set entity_id=null where entity_id=?
...
HHH000247: ErrorCode: 0, SQLState: 23502
ERROR: null value in column "entity_id" of relation "notification" violates not-null constraint
  Detail: Failing row contains (9, null, HAS_NO_INVOICE, A szállítólevél nincs számlához rendelve.).

结构相似的deleteAllByEntityIdAndTypeCode方法可正常执行，不会触发此类无意义的更新操作。

原因分析 #

问题核心在于JPA关联关系的维护端判定逻辑：

• DeliveryNote的@OneToMany注解仅使用@JoinColumn未指定mappedBy，Hibernate会误将DeliveryNote认定为关联关系的维护端（实际外键在通知表，维护端应为NotificationEntity）。
• 调用仅基于entityId的派生删除方法时，Hibernate会先加载关联的NotificationEntity实例，尝试解除关联（将entity_id设为null）后再执行删除，但entity_id存在非空约束，导致更新操作直接报错。
• deleteAllByEntityIdAndTypeCode方法正常的原因是：多条件匹配时，Hibernate判定可直接生成批量删除SQL，无需加载实体并维护关联关系，跳过了错误的更新步骤。

解决方案 #

方案1：明确关联关系维护端 #

修改DeliveryNote的@OneToMany注解，通过mappedBy将关联维护端交给NotificationEntity，同时添加orphanRemoval = true确保业务对象删除时级联删除通知：

class DeliveryNote(...) {
    @OneToMany(mappedBy = "deliveryNote", orphanRemoval = true)
    val notifications: List<NotificationEntity> = emptyList()
}

同时在NotificationEntity中添加对DeliveryNote的关联：

@Entity
@Table(name = "notification")
class NotificationEntity(

    @ManyToOne
    @JoinColumn(name = "entity_id")
    val deliveryNote: DeliveryNote,

    @Column(name = "type_code")
    val typeCode: String,

    val message: String,
) {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    var id: Long? = null
}

注：若通知对应多种业务对象，需通过@Inheritance或@DiscriminatorColumn实现多态关联。

方案2：强制执行批量删除SQL #

在仓库方法上添加@Modifying和@Query注解，手动编写删除语句，绕过Hibernate的关联维护逻辑：

interface NotificationRepository: JpaRepository<NotificationEntity, Long> {

    ...
    @Modifying
    @Query("DELETE FROM NotificationEntity ne WHERE ne.entityId = :entityId")
    fun deleteAllByEntityId(@Param("entityId") entityId: Long)

    fun deleteAllByEntityIdAndTypeCode(entityId: Long, typeCode: String)
    ...
}

该方式直接执行DELETE语句，无需加载实体和执行关联更新，既避免了非空约束错误，也提升了执行效率。

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