MyBatis-Plus的逻辑删除问题怎么解决

在现代的软件开发中，逻辑删除（Soft Delete）是一种常见的数据处理方式。与物理删除（Hard Delete）不同，逻辑删除并不会真正从数据库中移除数据，而是通过标记字段（如is_deleted）来表示数据已被删除。这种方式可以保留数据的历史记录，便于后续的审计和恢复操作。

MyBatis-Plus 作为 MyBatis 的增强工具，提供了对逻辑删除的支持。然而，在实际使用过程中，开发者可能会遇到一些问题。本文将详细介绍 MyBatis-Plus 中逻辑删除的实现方式，并探讨常见问题的解决方案。

1. MyBatis-Plus 逻辑删除的基本配置

1.1 数据库表设计

首先，我们需要在数据库表中添加一个用于标记删除状态的字段。通常，这个字段是一个布尔类型或整数类型的字段，例如：

ALTER TABLE user ADD COLUMN is_deleted TINYINT(1) DEFAULT 0 COMMENT '是否删除，0：未删除，1：已删除';

1.2 实体类配置

在 MyBatis-Plus 中，我们可以通过注解或全局配置来启用逻辑删除功能。假设我们有一个 User 实体类，对应的数据库表为 user，我们可以通过以下方式配置逻辑删除：

import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

@Data
@TableName("user")
public class User {
    private Long id;
    private String name;
    private Integer age;

    @TableLogic
    private Integer isDeleted;
}

在上述代码中，@TableLogic 注解用于标记逻辑删除字段。MyBatis-Plus 会自动识别该字段，并在执行删除操作时将其值更新为 1（表示已删除），而不是真正删除数据。

1.3 全局配置

除了在实体类中使用注解，我们还可以通过全局配置来启用逻辑删除功能。在 application.yml 或 application.properties 文件中添加以下配置：

mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: isDeleted  # 逻辑删除字段名
      logic-delete-value: 1         # 逻辑已删除值
      logic-not-delete-value: 0     # 逻辑未删除值

通过全局配置，我们可以在不修改实体类的情况下启用逻辑删除功能。

2. 逻辑删除的常见问题及解决方案

2.1 查询时自动过滤已删除数据

在启用逻辑删除后，MyBatis-Plus 会自动在所有查询语句中添加过滤条件，排除已删除的数据。例如，执行 select * from user 时，实际执行的 SQL 语句为：

SELECT * FROM user WHERE is_deleted = 0;

这种行为通常是符合预期的，但在某些场景下，我们可能需要查询所有数据（包括已删除的数据）。此时，我们可以通过以下方式绕过逻辑删除的自动过滤：

2.1.1 使用 @SqlParser 注解

MyBatis-Plus 提供了 @SqlParser 注解，可以用于关闭特定方法的 SQL 解析功能。例如：

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.annotation.SqlParser;
import org.apache.ibatis.annotations.Select;

public interface UserMapper extends BaseMapper<User> {

    @SqlParser(filter = true)
    @Select("SELECT * FROM user")
    List<User> selectAllIncludeDeleted();
}

在上述代码中，@SqlParser(filter = true) 注解用于关闭 SQL 解析功能，从而绕过逻辑删除的自动过滤。

2.1.2 使用 Wrapper 自定义查询条件

我们还可以通过 QueryWrapper 自定义查询条件，手动控制是否包含已删除的数据。例如：

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("is_deleted", 1);  // 查询已删除的数据
List<User> deletedUsers = userMapper.selectList(wrapper);

2.2 逻辑删除与唯一约束冲突

在某些情况下，逻辑删除可能会导致唯一约束冲突。例如，假设 user 表中的 name 字段具有唯一约束，当我们删除一个用户后，再尝试插入一个同名用户时，可能会触发唯一约束冲突。

为了解决这个问题，我们可以采用以下两种方式：

2.2.1 修改唯一约束

我们可以修改数据库表的唯一约束，使其包含逻辑删除字段。例如：

ALTER TABLE user ADD UNIQUE (name, is_deleted);

这样，即使 name 相同，只要 is_deleted 不同，就不会触发唯一约束冲突。

2.2.2 使用复合主键

另一种方式是使用复合主键，将逻辑删除字段作为主键的一部分。例如：

ALTER TABLE user DROP PRIMARY KEY, ADD PRIMARY KEY (id, is_deleted);

这种方式可以避免唯一约束冲突，但可能会增加数据库设计的复杂性。

2.3 逻辑删除与关联查询

在进行关联查询时，逻辑删除可能会导致查询结果不准确。例如，假设我们有一个 order 表与 user 表关联，当我们查询订单时，可能会关联到已删除的用户。

为了解决这个问题，我们可以在关联查询时手动添加过滤条件。例如：

QueryWrapper<Order> wrapper = new QueryWrapper<>();
wrapper.eq("o.user_id", userId)
       .eq("u.is_deleted", 0);  // 过滤已删除的用户
List<Order> orders = orderMapper.selectList(wrapper);

2.4 逻辑删除与数据恢复

在某些场景下，我们可能需要恢复已删除的数据。MyBatis-Plus 提供了 update 方法，可以用于更新逻辑删除字段的值。例如：

User user = new User();
user.setId(1L);
user.setIsDeleted(0);  // 恢复数据
userMapper.updateById(user);

通过这种方式，我们可以将已删除的数据标记为未删除，从而实现数据恢复。

3. 总结

MyBatis-Plus 提供了对逻辑删除的良好支持，但在实际使用过程中，开发者可能会遇到一些问题。本文详细介绍了 MyBatis-Plus 中逻辑删除的基本配置，并探讨了常见问题的解决方案。通过合理配置和使用，我们可以充分发挥逻辑删除的优势，同时避免潜在的问题。

希望本文能帮助你更好地理解和解决 MyBatis-Plus 中的逻辑删除问题。如果你有任何疑问或建议，欢迎在评论区留言讨论。