通用业务设计---如何解决'逻辑删除'和'唯一索引'冲突的问题

Aska_Lv2025-03-20 9:49

如何解决'逻辑删除'和'唯一索引'冲突的问题

概括

简单一句话

把del_flag 0值：代表未删除 null值：代表删除

场景

当要对保证某些可编辑字段的唯一性时，代码需要在插入和更新时都进行唯一性校验，这很繁琐。

因此想到采用将对于唯一性的校验直接交给数据库进行，通过数据库唯一索引实现。

但这就又出现了另一个问题：由于采用的是"逻辑删除"，那么会造成唯一字段值相同的数据只能删除一次的情况。第二次删除时，由于已存在 del_flag 值为 1 的数据，会报错"违反唯一约束"

解决方案

基于mysql"唯一约束对 Null 失效"的原理，将被删数据的逻辑删除字段置为 null 即可。如果使用的是 mybatis-plus，可以直接通过@TableLogic注解实现

java 复制代码

    /**
     * 是否删除
     *
     * <p>
     *     为解决'逻辑删除'和'唯一索引'冲突问题，而将逻辑删除字段设置为NULL
     * </p>
     */
    @TableLogic(value = "0", delval = "NULL")
    private Boolean deleteFlag;

这样就可以在数据库层面轻松实现唯一性的保证，且'逻辑删除'和'唯一索引'不会冲突。

此时当入参违反唯一性约束时就会抛出异常，我们需要对异常进行处理，以向前端返回更加友好的报错信息。

java 复制代码

try {
    thisGiftProductService.saveThisGiftProduct(thisGiftProductDO, request);
    return RestResult.<Void>builder().success("保存成功");
} catch (Exception e) {
    log.error("新增错误", e);
    Throwable cause = e.getCause();
    if (cause instanceof java.sql.SQLIntegrityConstraintViolationException) {
        return RestResult.<Void>builder().fail("本品产品编码和组织信息组合不能重复");
    }
    return RestResult.<Void>builder().fail(e.getMessage());
}

核心在于：

java 复制代码

log.error("新增错误", e);
Throwable cause = e.getCause();
if (cause instanceof java.sql.SQLIntegrityConstraintViolationException) {
    return RestResult.<Void>builder().fail("本品产品编码和组织信息组合不能重复");
}

之所以采用这种方法，是因为 java.sql.SQLIntegrityConstraintViolationException 异常是无法作为 catch 参数捕捉的。