在 MyBatis-Plus開啟邏輯刪除 的情況下，updateById更新邏輯刪除字段時(shí)， “看起來執(zhí)行了但實(shí)際上沒有更新”的問題是一種較為常見但不易察覺的問題。

背景：

項(xiàng)目中使用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);

執(zhí)行結(jié)果沒有明顯報(bào)錯(cuò)，也不會(huì)有異常日志，但實(shí)際沒有更新邏輯刪除字段。

如果沒有記錄執(zhí)行返回值進(jìn)行判斷，將導(dǎo)致邏輯刪除失敗問題被隱藏，為后續(xù)業(yè)務(wù)埋雷。

原因分析：

mybatis-plus使用邏輯刪除背景下，使用updateById時(shí)，如下代碼段：

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

執(zhí)行的sql語句是：

 UPDATE table_name 
 SET deleted = 1 
 WHERE id = ? 
   AND deleted = 0;  -- ?? MyBatis-Plus 自動(dòng)添加的條件

這條 SQL 在語法層面是合法的，但在 MyBatis-Plus 的設(shè)計(jì)語義中，邏輯刪除并不被視為一次普通的 update 操作。

MyBatis-Plus 將“刪除”與“更新”在內(nèi)部邏輯上進(jìn)行了區(qū)分：updateById 被設(shè)計(jì)為只能作用于“未被邏輯刪除的數(shù)據(jù)”，而邏輯刪除本身應(yīng)通過 delete 系列方法觸發(fā)。

 -- 你期望生成的SQL（框架不會(huì)生成）
 UPDATE record SET deleted = 1 WHERE id = ? AND deleted = 0;
 -- updateById實(shí)際生成的SQL（deleted字段被剔除）
 UPDATE record SET other_field=? WHERE id = ? AND deleted = 0;

Mybatis-Plus為什么要這樣設(shè)計(jì)：

MyBtis-Plus 遵循 "語義隔離" 原則

關(guān)鍵機(jī)制：

• 攔截器過濾：LogicDeleteInterceptor 會(huì)自動(dòng)移除 SET 子句中的邏輯刪除字段
• 條件追加：所有查詢/更新操作都會(huì)自動(dòng)追加AND deleted = 0
• 單向操作：邏輯刪除被視為不可逆操作（刪除后不應(yīng)通過業(yè)務(wù)代碼恢復(fù)）

如何正確處理：

• 使用 MyBatis-Plus 提供的 deleteById 進(jìn)行邏輯刪除

 // 框架會(huì)自動(dòng)生成：UPDATE user SET deleted=1 WHERE id=? AND deleted=0
 recordMapper.deleteById(1L); 

　　在開啟邏輯刪除的前提下，deleteById 不會(huì)執(zhí)行物理刪除，而是由 MyBatis-Plus 自動(dòng)生成邏輯刪除 SQL，其語義與框架設(shè)計(jì)完全一致。

• 用 LambdaUpdateWrapper 顯式執(zhí)行邏輯刪除

  // 手動(dòng)指定SET子句，繞過字段過濾
 LambdaUpdateWrapper<Record> wrapper = new LambdaUpdateWrapper<>();
 wrapper.eq(Record::getId, 1L).set(Record::getDeleted, 1); // 強(qiáng)制設(shè)置deleted字段
 recordMapper.update(null, wrapper);

　　如果業(yè)務(wù)上必須通過 update 的方式完成邏輯刪除，可以使用 LambdaUpdateWrapper，自行控制 WHERE 條件，避免與 MyBatis-Plus 的自動(dòng)邏輯刪除條件產(chǎn)生沖突。此方式繞過了 updateById 的內(nèi)置邏輯刪除約束，應(yīng)明確其用途，避免被誤用為普通更新。

• 自定義 SQL 明確邏輯刪除語

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

　　適合對邏輯刪除行為有強(qiáng)語義要求的項(xiàng)目，便于代碼閱讀和后期維護(hù)。

總結(jié)：

在 MyBatis-Plus 中，邏輯刪除不是一次普通的字段更新操作。updateById 被設(shè)計(jì)為只能更新“未被邏輯刪除的數(shù)據(jù)”，而不用于觸發(fā)邏輯刪除本身。當(dāng)更新語句同時(shí)在 SET 和 WHERE 中涉及邏輯刪除字段時(shí)，就會(huì)與框架的設(shè)計(jì)語義產(chǎn)生沖突。正確的做法是使用 delete 系列方法，或通過 Wrapper / 自定義 SQL 明確表達(dá)“邏輯刪除”的意圖。

到此這篇關(guān)于Mybatis-Plus更新操作時(shí)的一個(gè)坑的文章就介紹到這了,更多相關(guān)Mybatis-Plus更新操作時(shí)的一個(gè)坑內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論