【Mybatis-plus异常】mybatis-plus updateById方法更新不了空字符串和null的解决方法

最新推荐文章于 2025-06-03 18:01:23 发布

No8g攻城狮

最新推荐文章于 2025-06-03 18:01:23 发布

阅读量7.8k

点赞数 7

CC 4.0 BY-SA版权

分类专栏： Mybatis 异常解决方案文章标签： sql 数据库 java mybatis mybaits-plus

本文链接：https://blog.csdn.net/weixin_44299027/article/details/120140413

异常解决方案同时被 2 个专栏收录

154 篇文章

订阅专栏

Mybatis

22 篇文章

订阅专栏

本文介绍了在SpringBoot+MyBatis-Plus项目中遇到更新字段为空值失败的问题，分析了原因在于全局配置FieldStrategy设为了NOT_NULL。提供了三种解决方法：全局配置调整验证策略为IGNORED，字段注解调整为@TableField(strategy=FieldStrategy.NOT_EMPTY)，以及使用UpdateWrapper设置为空值。选择合适的方法可以避免影响其他业务数据的正确性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文目录

方式三：使用 UpdateWrapper (3.x)

一、背景描述

项目所有技术栈，spring boot (2.1.5.RELEASE) + mybatis-plus (3.3.1.tmp) + 其他。重点是这里使用了 mybatis-plus。

由于享受了懒人福利（不写或者少写sql语句），但是也或多或少的踩了一些别人没有踩到的坑。比如今天在使用 mybatis-plus updateById()方法更新数据库字段时，就遇到了糟心事儿，本来想把某个字段更新为空呢，结果竟然没有更新成功。其他非空字段更新正常。

二、问题原因

至于为什么某个字段更新为空会失败，首先想到的是可能与配置有关。所以去看配置文件，查看关于 mybatis-plus 相关的配置。

看到这个关于 mybatis-plus 配置项目后，有个 global-config 全局配置，field-strategy 字段策略被标注为 NOT_NULL 。然后一下子就明白了是怎么回事。

关于 mybatis-plus 插入或更新的字段有空字符串或者 null 时，mybatis-plus 官网上有关于这个问题的解决方案。

在这里，介绍一下 FieldStrategy 有三种策略：

IGNORED：忽略
NOT_NULL：非 NULL，默认策略
NOT_EMPTY：非空

用户有更新字段为空字符串或者 null 的需求时，需要对 FieldStrategy 策略进行调整。

以上也是 mybatis-plus 官网上原文。

以下是 com.baomidou.mybatisplus.annotation.FieldStrategy 源码。DEFAULT是默认，这个不用管。

三、解决办法

mybatis-plus 官网上给出了三种解决方法，以下为摘取自 mybatis-plus 官网。想看官网的也可以，官网上的链接地址：https://mp.baomidou.com/guide/faq.html#插入或更新的字段有-空字符串-或者-null

方式一：调整全局的验证策略

注入配置 GlobalConfiguration 属性 fieldStrategy。

具体到我的项目里就是将 field-strategy 属性设备为 IGNORED，即忽略判断策略。

这样做是全局性配置，会对所有的字段都忽略判断，如果一些字段不想要修改，但是传值的时候没有传递过来，就会被更新为null，可能会影响其他业务数据的正确性。

方式二：调整字段验证注解

根据具体情况，在需要更新的字段中调整验证注解，如验证非空：

@TableField(strategy=FieldStrategy.NOT_EMPTY)

具体到我的项目里，是这样的：

我只是在对象里需要更新的字段上添加了 @TableField 注解，使用了更新策略。

使用上述方法，如果需要这样处理的字段较多，那么就需要涉及对各个字段上都添加该注解，显得有些麻烦了。

方式三：使用 UpdateWrapper (3.x)

使用以下方法来进行更新或插入操作：

//updateAllColumnById(entity) // 全部字段更新: 3.0已经移除
mapper.update(
   new User().setName("mp").setAge(3),
   Wrappers.<User>lambdaUpdate()
           .set(User::getEmail, null) //把email设置成null
           .eq(User::getId, 2)
);
//也可以参考下面这种写法
mapper.update(
    null,
    Wrappers.<User>lambdaUpdate()
       .set(User::getAge, 3)
       .set(User::getName, "mp")
       .set(User::getEmail, null) //把email设置成null
       .eq(User::getId, 2)
);

完结！