MyBatis-Plus的逻辑删除：@TableLogic与全局配置的优缺点

搞Java开发的小伙伴们肯定对MyBatis-Plus不陌生，今天咱就唠唠它里面两个实用的功能：逻辑删除和批量操作。逻辑删除就像是给数据“打个标记”，而不是真的删掉；批量操作能让咱们高效处理一堆数据记录。下面直接上干货，结合代码详细讲讲！

一、MyBatis-Plus逻辑删除是啥？

逻辑删除可不是真把数据从数据库里抹掉，而是给数据加个特殊标记。比如说，在数据库表里面加个 deleted 字段，用0表示数据正常，1就表示已经被“删除”了。当咱们查询数据的时候，系统会自动把那些 deleted 字段为1的数据过滤掉；删除数据的时候，也不是真的把数据删掉，只是把这个标记改成1就行。这样一来，历史数据能保留下来，平时正常查询也不受影响，是不是很方便？

二、配置逻辑删除

MyBatis-Plus的逻辑删除功能用起来很方便，不过得先做些准备工作。

2.1 表结构设计

假设咱们有个 user 表，里面有 id、username、age 这些字段，还得有个 deleted 字段（类型是int），用来表示数据是否被删除。0代表正常，1就代表被删除了。

2.2 实体类配置

在实体类里，得加个 @TableLogic 注解。看下面这段代码：

import com.baomidou.mybatisplus.annotation.TableLogic; import com.baomidou.mybatisplus.annotation.TableName; import lombok.Data; // 下面这个User类是和数据库中user表对应的实体类 // @Data注解能自动生成getter、setter等方法，方便操作属性 // @TableName指定了对应的数据库表名 @Data @TableName("user") public class User { private Long id; private String username; private Integer age; // @TableLogic注解标记这个字段是逻辑删除字段 @TableLogic private Integer deleted; }

2.3 全局配置（可选）

要是想统一设置逻辑删除的相关参数，还可以在 application.yml 里进行全局配置：

mybatis-plus: global-config: db-config: logic-delete-field: deleted # 全局逻辑删除字段 logic-delete-value: 1 # 删除时的值 logic-not-delete-value: 0 # 未删除时的值

加了这个全局配置之后，实体类里的 @TableLogic 注解就可以不写了，系统会默认按照全局配置来。

2.4 Mapper配置

Mapper还是老样子，继承 BaseMapper 就行：

public interface UserMapper extends BaseMapper<User> { }

三、实战：逻辑删除操作

配置好之后，就可以来试试逻辑删除的效果了。逻辑删除主要用 deleteById 或者 delete 方法，MyBatis-Plus会自动把这些删除操作转成 UPDATE 操作。

3.1 单个删除

@SpringBootTest class LogicDeleteTest { // 自动注入UserMapper，方便调用里面的方法操作数据库 @Autowired private UserMapper userMapper; // 这个测试方法用来测试根据id进行逻辑删除的功能 @Test void testDeleteById() { userMapper.deleteById(1L); System.out.println("ID=1 的用户被逻辑删除了！"); } }

执行完这段代码，去数据库里看，这条记录的 deleted 字段就变成1了，但数据其实还在数据库里。MyBatis-Plus实际执行的SQL是这样的：

UPDATE user SET deleted=1 WHERE id=1 AND deleted=0

3.2 条件删除

@Test void testDeleteByCondition() { userMapper.delete(new QueryWrapper<User>().eq("age", 25)); System.out.println("25岁的都被逻辑删了！"); }

对应的SQL语句是：

UPDATE user SET deleted=1 WHERE age=25 AND deleted=0

四、查询时自动过滤

逻辑删除还有个好处，就是查询数据的时候，系统会自动带上 deleted=0（或者你配置的未删除值）这个条件。看下面这个查询代码：

@Test void testSelect() { List<User> users = userMapper.selectList(null); users.forEach(System.out::println); }

执行的SQL语句是：

SELECT id, username, age, deleted FROM user WHERE deleted=0

这样一来，被删除的数据就不会出现在查询结果里，咱们就不用手动去加这个过滤条件了，是不是很省心？

五、想查已删除的数据怎么办？

有时候，咱们可能需要查看那些被逻辑删除的数据，这时候就得动点小脑筋了。

一种方法是自定义SQL语句：

@Select("SELECT * FROM user WHERE deleted=1") List<User> selectDeleted();

还有一种方法，就是用 Wrapper 来跳过逻辑删除：

@Test void testSelectWithDeleted() { List<User> users = userMapper.selectList(new QueryWrapper<User>().eq("deleted", 1)); users.forEach(System.out::println); }