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

一、邏輯刪除核心概念

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

• 未刪除：標記字段值為 0（默認）；
• 已刪除：標記字段值為 1（默認）。

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

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

1. 數據庫表添加標記字段

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

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

2. 實體類配置標記字段

在實體類中添加 deleted 字段，并通過 @TableLogic 注解標記為邏輯刪除字段：

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

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

3. 全局配置邏輯刪除參數

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

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

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

三、邏輯刪除操作案例

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

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

調用 deleteById 等刪除方法時，MyBatis-Plus 會自動生成更新標記字段的 SQL：

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

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

2. 查詢操作（自動過濾已刪除數據）

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

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

3. 更新操作（僅更新未刪除數據）

更新操作會自動添加 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 類型，默認值 0（未刪除），避免使用 BIT 類型（部分數據庫兼容性差）。
2. 索引優(yōu)化：在 deleted 字段上建立索引，提升查詢時的條件過濾效率。
3. 配合自動填充：結合 MyBatis-Plus 的自動填充功能，在插入數據時自動為 deleted 字段賦值 0（未刪除）：

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

   然后在填充類中設置默認值：

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

總結

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

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

最新評論