Mybatis-Plus更新操作时遇到的问题及解决方法

在 MyBatis-Plus开启逻辑删除 的情况下，updateById更新逻辑删除字段时， “看起来执行了但实际上没有更新”的问题是一种较为常见但不易察觉的问题。

背景：

项目中使用mybatis-plus且已开启逻辑删除：

 mybatis-plus:
   global-config:
     db-config:
       logic-delete-field: deleted
       logic-delete-value: 1
       logic-not-delete-value: 0
       update-strategy: not_empty   #更新策略只更新非空

在代码中获取记录并更新逻辑删除字段：

 useRecord record = RecordMapper.selectOne(...); 
 record.setDeleted(1);
 RecordMapper.updateById(record);

执行结果没有明显报错，也不会有异常日志，但实际没有更新逻辑删除字段。

如果没有记录执行返回值进行判断，将导致逻辑删除失败问题被隐藏，为后续业务埋雷。

原因分析：

mybatis-plus使用逻辑删除背景下，使用updateById时，如下代码段：

 record.setDeleted(1);
 RecordMapper.updateById(record);

执行的sql语句是：

 UPDATE table_name 
 SET deleted = 1 
 WHERE id = ? 
   AND deleted = 0;  -- ⚠️ MyBatis-Plus 自动添加的条件

这条 SQL 在语法层面是合法的，但在 MyBatis-Plus 的设计语义中，逻辑删除并不被视为一次普通的 update 操作。

MyBatis-Plus 将“删除”与“更新”在内部逻辑上进行了区分：updateById 被设计为只能作用于“未被逻辑删除的数据”，而逻辑删除本身应通过 delete 系列方法触发。

 -- 你期望生成的SQL（框架不会生成）
 UPDATE record SET deleted = 1 WHERE id = ? AND deleted = 0;
 -- updateById实际生成的SQL（deleted字段被剔除）
 UPDATE record SET other_field=? WHERE id = ? AND deleted = 0;

Mybatis-Plus为什么要这样设计：

MyBtis-Plus 遵循 "语义隔离" 原则

关键机制：

• 拦截器过滤：LogicDeleteInterceptor 会自动移除 SET 子句中的逻辑删除字段
• 条件追加：所有查询/更新操作都会自动追加AND deleted = 0
• 单向操作：逻辑删除被视为不可逆操作（删除后不应通过业务代码恢复）

如何正确处理：

• 使用 MyBatis-Plus 提供的 deleteById 进行逻辑删除

 // 框架会自动生成：UPDATE user SET deleted=1 WHERE id=? AND deleted=0
 recordMapper.deleteById(1L); 

　　在开启逻辑删除的前提下，deleteById 不会执行物理删除，而是由 MyBatis-Plus 自动生成逻辑删除 SQL，其语义与框架设计完全一致。

• 用 LambdaUpdateWrapper 显式执行逻辑删除

  // 手动指定SET子句，绕过字段过滤
 LambdaUpdateWrapper<Record> wrapper = new LambdaUpdateWrapper<>();
 wrapper.eq(Record::getId, 1L).set(Record::getDeleted, 1); // 强制设置deleted字段
 recordMapper.update(null, wrapper);

　　如果业务上必须通过 update 的方式完成逻辑删除，可以使用 LambdaUpdateWrapper，自行控制 WHERE 条件，避免与 MyBatis-Plus 的自动逻辑删除条件产生冲突。此方式绕过了 updateById 的内置逻辑删除约束，应明确其用途，避免被误用为普通更新。

• 自定义 SQL 明确逻辑删除语

 @Update("UPDATE record SET deleted = 1 WHERE id = #{id} AND deleted = 0")
 int logicDeleteById(Long id);

　　适合对逻辑删除行为有强语义要求的项目，便于代码阅读和后期维护。

总结：

在 MyBatis-Plus 中，逻辑删除不是一次普通的字段更新操作。updateById 被设计为只能更新“未被逻辑删除的数据”，而不用于触发逻辑删除本身。当更新语句同时在 SET 和 WHERE 中涉及逻辑删除字段时，就会与框架的设计语义产生冲突。正确的做法是使用 delete 系列方法，或通过 Wrapper / 自定义 SQL 明确表达“逻辑删除”的意图。

到此这篇关于Mybatis-Plus更新操作时的一个坑的文章就介绍到这了,更多相关Mybatis-Plus更新操作时的一个坑内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论