Spring Boot软删除触发DataIntegrityViolationException问题求助

先盯紧@SQLDelete的SQL写法 #

这绝对是最常见的问题根源。比如你的Permission实体有id主键和is_deleted软删字段，@SQLDelete必须写成：

@SQLDelete(sql = "UPDATE permission SET is_deleted = true WHERE id = ?")

注意这里的?是JPA默认的位置占位符，只对应主键参数。要是你写了多余的占位符，或者顺序搞反了，PostgreSQL直接就会报列索引越界——因为它找不到对应位置的参数。

检查@Where注解的过滤逻辑 #

@Where得准确过滤未删除的数据，别加多余内容：

@Where(clause = "is_deleted = false")

要是这里字段名写错，或者加了奇怪的条件，会打乱JPA生成的SQL结构，间接导致参数绑定错误。

核对实体字段和数据库表的映射 #

• 先确认is_deleted字段的@Column注解和数据库列名一致——PostgreSQL区分大小写，要是数据库列是is_deleted，实体要么字段名全小写，要么加@Column(name = "is_deleted")。
• 字段类型也得对应：数据库用boolean的话，实体就用Java的Boolean；要是数据库存的是smallint（0/1），实体也要匹配，类型不匹配会导致参数绑定失败。

检查Repository的删除方法 #

如果你的Repository继承了JpaRepository，默认的deleteById方法会被@SQLDelete覆盖，但要是自定义了删除方法，比如deleteByPermissionName(String name)，得确保它的逻辑和软删除兼容。要么让JPA自动生成正确的软删SQL，要么手动加@Query指定：

@Modifying
@Query("UPDATE Permission p SET p.isDeleted = true WHERE p.permissionName = ?1")
void deleteByPermissionName(String name);

开SQL日志看真实执行语句 #

直接在application.yml里加日志配置，把执行的SQL打出来：

spring:
  jpa:
    show-sql: true
    properties:
      hibernate:
        format_sql: true

这样能直观看到软删时到底执行了什么SQL，参数绑定对不对——比如是不是多了个占位符，或者字段名写错了，一眼就能排查出问题。

内容的提问来源于stack exchange，提问作者Yunus Emre Alpu