在實(shí)際開發(fā)中，直接從數(shù)據(jù)庫刪除數(shù)據(jù)（物理刪除）存在誤操作后難以恢復(fù)的風(fēng)險(xiǎn)。MyBatis-Plus 提供的邏輯刪除功能通過標(biāo)記字段標(biāo)識數(shù)據(jù)狀態(tài)，既保留了數(shù)據(jù)完整性，又實(shí)現(xiàn)了“刪除”效果。

一、邏輯刪除核心概念

邏輯刪除并非真正從數(shù)據(jù)庫中刪除數(shù)據(jù)，而是通過一個標(biāo)記字段（如 deleted）記錄數(shù)據(jù)狀態(tài)：

• 未刪除：標(biāo)記字段值為 0（默認(rèn)）；
• 已刪除：標(biāo)記字段值為 1（默認(rèn)）。

執(zhí)行“刪除”操作時，實(shí)際執(zhí)行的是更新標(biāo)記字段的 SQL；查詢數(shù)據(jù)時，自動過濾已刪除的記錄。這種方式既避免了數(shù)據(jù)丟失，又不影響業(yè)務(wù)查詢邏輯。

二、邏輯刪除實(shí)現(xiàn)步驟

1. 數(shù)據(jù)庫表添加標(biāo)記字段

在需要支持邏輯刪除的表中添加 deleted 字段（名稱可自定義），類型為整數(shù)，默認(rèn)值設(shè)為 0（未刪除）：

-- 以 student 表為例
ALTER TABLE student ADD COLUMN deleted INT DEFAULT 0 COMMENT '邏輯刪除標(biāo)記（0-未刪，1-已刪）';

2. 實(shí)體類配置標(biāo)記字段

在實(shí)體類中添加 deleted 字段，并通過 @TableLogic 注解標(biāo)記為邏輯刪除字段：

@Data
public class Student {
    @TableId(type = IdType.AUTO)
    private Integer id;
    private String name;
    private Integer age;
    private String gender;
    
    // 邏輯刪除標(biāo)記字段
    @TableLogic
    private Integer deleted;
}

@TableLogic 注解的作用是：告訴 MyBatis-Plus 該字段用于邏輯刪除，自動參與 SQL 拼接。

3. 全局配置邏輯刪除參數(shù)

在 application.yml 中配置邏輯刪除的字段名、未刪除值和已刪除值（默認(rèn)值可省略）：

mybatis-plus:
  global-config:
    db-config:
      # 邏輯刪除字段名（與實(shí)體類字段一致）
      logic-delete-field: deleted
      # 邏輯未刪除值（默認(rèn)0）
      logic-not-delete-value: 0
      # 邏輯已刪除值（默認(rèn)1）
      logic-delete-value: 1

通過全局配置，所有實(shí)體類的邏輯刪除字段將統(tǒng)一遵循此規(guī)則。

三、邏輯刪除操作案例

配置完成后，原有的 CRUD 方法會自動適配邏輯刪除規(guī)則：

1. 刪除操作（實(shí)際執(zhí)行更新）

調(diào)用 deleteById 等刪除方法時，MyBatis-Plus 會自動生成更新標(biāo)記字段的 SQL：

@Test
public void testDelete() {
    // 調(diào)用刪除方法（實(shí)際執(zhí)行：UPDATE student SET deleted=1 WHERE id=1 AND deleted=0）
    studentMapper.deleteById(1);
}

執(zhí)行后，id=1 的記錄 deleted 字段變?yōu)?1，而非從表中刪除。

2. 查詢操作（自動過濾已刪除數(shù)據(jù)）

執(zhí)行查詢時，MyBatis-Plus 會自動在 SQL 中添加 deleted=0 條件，過濾已刪除數(shù)據(jù)：

@Test
public void testSelect() {
    // 查詢所有未刪除數(shù)據(jù)（自動添加條件：WHERE deleted=0）
    List<Student> students = studentMapper.selectList(null);
    
    // 根據(jù)ID查詢（自動添加條件：WHERE id=1 AND deleted=0）
    Student student = studentMapper.selectById(1); 
    // 若id=1的記錄已被邏輯刪除，返回null
}

3. 更新操作（僅更新未刪除數(shù)據(jù)）

更新操作會自動添加 deleted=0 條件，避免更新已刪除的記錄：

@Test
public void testUpdate() {
    Student student = new Student();
    student.setId(1);
    student.setName("更新測試");
    
    // 執(zhí)行更新（自動添加條件：WHERE id=1 AND deleted=0）
    studentMapper.updateById(student);
    // 若記錄已被邏輯刪除，更新無效果
}

四、邏輯刪除與物理刪除的區(qū)別

五、建議

1. 字段類型選擇：邏輯刪除字段建議使用 INT 類型，默認(rèn)值 0（未刪除），避免使用 BIT 類型（部分?jǐn)?shù)據(jù)庫兼容性差）。
2. 索引優(yōu)化：在 deleted 字段上建立索引，提升查詢時的條件過濾效率。
3. 配合自動填充：結(jié)合 MyBatis-Plus 的自動填充功能，在插入數(shù)據(jù)時自動為 deleted 字段賦值 0（未刪除）：

   @TableField(fill = FieldFill.INSERT)
   @TableLogic
   private Integer deleted;
   

   然后在填充類中設(shè)置默認(rèn)值：

   @Override
   public void insertFill(MetaObject metaObject) {
       this.setFieldValByName("deleted", 0, metaObject);
   }
   

總結(jié)

邏輯刪除通過標(biāo)記字段實(shí)現(xiàn)數(shù)據(jù)“假刪除”，既保障了數(shù)據(jù)安全，又簡化了恢復(fù)操作，是核心業(yè)務(wù)數(shù)據(jù)的最佳刪除方案。MyBatis-Plus 通過 @TableLogic 注解和全局配置，自動適配 CRUD 方法的 SQL 生成，無需手動編寫特殊邏輯。

到此這篇關(guān)于MyBatis-Plus 邏輯刪除的實(shí)現(xiàn)示例的文章就介紹到這了,更多相關(guān)MyBatis-Plus 邏輯刪除內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論