快捷導(dǎo)航

Mybatis?Plus字段為空值時未更新問題及解決

更新時間：2026年05月15日 08:48:47 作者：讓丄帝愛伱

在使用MybatisPlus的UpdateById()方法時,如果字段從前臺傳入的數(shù)據(jù)為空值,則該字段不會得到更新,可以通過使用@TableField注解的fill屬性、全局配置update-strategy屬性或使用UpdateWrapper類來解決此問題

方案一注解方式

進入@TableField注解的相關(guān)內(nèi)容。

在該注解的屬性描述內(nèi)，有這樣一個字段——“fill”，字段自動填充策略。


fill	Enum	否	FieldFill.DEFAULT	字段自動填充策略

它決定了在執(zhí)行新增或修改方法時，有這個注解的字段需要怎樣將數(shù)據(jù)進行填充，F(xiàn)ieldFill的相關(guān)的屬性，官方描述如下：

值	描述
DEFAULT	默認不處理
INSERT	插入時填充字段
UPDATE	更新時填充字段
INSERT_UPDATE	插入和更新時填充字段

默認值是DEFAULT，默認不處理，即本次出現(xiàn)的問題——新增、修改該字段為空時，將不自動填充即不列入語句，如：

insert into shop_item(shop_price) values(xxxx);
update shop_item set shop_price = xxxx;

@Data
@TableName("shop_item")
public class ShopItem implements Serializable {
 
 
     private static final long serialVersionUID = 1L;
 
    /**
     * 編號
     */
    @TableId(type= IdType.INPUT)
    private String id;
 
    /**
     * 物品名稱
     */
    private String itemName;
 
    /**
     * 物品價格
     */
    @TableField(fill = FieldFill.UPDATE)
    private Double itemPrice;
 
    /**
    *    添加人編號
    */
    private String addUserId;
 
    /**
    *    添加時間
    */
    private Date addTime;
}

在itemPrice屬性的頂上加上@TableField(fill = FieldFill.UPDATE)后，在執(zhí)行一遍查看SQL

update 
    shop_item 
set 
    item_name = 'iPhone',
    item_price = ''
where 
id = '361E8C48-6699-4ED5-83C4-7C9D98747C2C';

方案二全局配置

根據(jù)方案一中，F(xiàn)ieldStrategy 的三種策略：IGNORED、NOT_NULL、NOT_EMPTY，

可以在 application.yml 配置文件中注入配置 GlobalConfiguration 屬性 update-strategy，

將 update-strategy 策略調(diào)整為 IGNORED，即忽略判斷策略。即可調(diào)整全局的驗證策略。

如下所示：

# yml 配置：
mybatis-plus:
  global-config:
    db-config:
      update-strategy: IGNORED

全局性配置會對所有的字段都忽略判斷，如果有特殊字段處理，可以單獨配置，修改字段的策略。

設(shè)定全局配置，可以減少一個一個字段去指定增加的麻煩。

方案三：使用 UpdateWrapper (3.x) 更新

mp 提供了 UpdateWrapper 類簡化更新的操作，

針對方法級進行操作，只需操作其更新方法，相比較方案一和方案二，方案三影響范圍較小。

由于 BaseMapper 的繼承 Mapper ，在 BaseMapper

/**
 * 根據(jù) whereEntity 條件，更新記錄
 *
 * @param entity        實體對象 (set 條件值,可以為 null)
 * @param updateWrapper 實體對象封裝操作類（可以為 null,里面的 entity 用于生成 where 語句）
 */
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);

看出，實體對象可以 set 條件值且為可以為 null，說明有兩種方法可以實現(xiàn)更新操作（采用 lambda 表達式）：

將需要更新的字段，設(shè)置到 entity 中
將 entity設(shè)置為 null ，將需要更新的字段設(shè)置到 UpdateWrapper 中

mapper.update(
    null,
    Wrappers.<User>lambdaUpdate()
       .set(User::getAge, 3)
       .set(User::getName, "mp")
       .set(User::getEmail, null) //把email設(shè)置成null
       .eq(User::getId, 2)
);