MyBatis-Plus 默认不更新 null？这 4 种方法帮你搞定

在MyBatis-Plus里，更新null字段是一个非常常见、也非常容易踩坑的问题。
很多人会遇到这种情况：

我明明setXxx(null)了，为什么数据库里还是原来的值？

下面我按原因 → 解决方案 → 使用建议来整理一下。

一、为什么 MyBatis-Plus 默认不更新 null？

这是MyBatis-Plus 的设计行为，不是 bug。

默认情况下：

@TableField(updateStrategy = FieldStrategy.NOT_NULL)

也就是说：

字段为null，就不会出现在 UPDATE 语句里

目的是为了：

• • 防止误操作把字段更新成null

• • 更符合大多数“只更新有值字段”的业务场景

所以你写：

User user = new User(); user.setId(1L); user.setEmail(null); userMapper.updateById(user);

实际生成的 SQL 类似：

UPDATE user SET id = ? WHERE id = ?

email根本没参与更新。

二、更新 null 的几种正确方式（重点）

方式一：使用@TableField(updateStrategy = FieldStrategy.IGNORED)（最推荐）

@TableField(updateStrategy = FieldStrategy.IGNORED) private String email;

含义是：

不管是不是 null，都参与 update

这时：

user.setEmail(null); userMapper.updateById(user);

生成 SQL：

UPDATE user SET email = NULL WHERE id = ?

适合场景

• • 这个字段本来就允许被清空

• • 例如：备注、头像、手机号、邮箱

方式二：在实体类级别统一策略

@TableName(value = "user", autoResultMap = true) public class User { }

配合全局配置（不太常用，可以了解）：

mybatis-plus: global-config: db-config: update-strategy: ignored

慎用

• • 会导致所有字段都能被更新为 null

• • 风险较大，不适合复杂业务

方式三：使用UpdateWrapper（最灵活）

如果你不想改实体类：

UpdateWrapper<User> wrapper = new UpdateWrapper<>(); wrapper.eq("id", 1L) .set("email", null); userMapper.update(null, wrapper);

生成 SQL：

UPDATE user SET email = NULL WHERE id = ?

适合场景

• • 后台管理

• • 批量操作

• • 精准控制 SQL

方式四：使用LambdaUpdateWrapper

LambdaUpdateWrapper<User> wrapper = Wrappers.lambdaUpdate(); wrapper.eq(User::getId, 1L) .set(User::getEmail, null); userMapper.update(null, wrapper);

类型安全、IDE 友好，实际项目更推荐

三、一个容易忽略的坑

逻辑删除字段 + 更新 null

如果你用了：

@TableLogic private Integer deleted;

一定要确认：

• •Wrapper里有没有被逻辑删除条件影响

• • 有些更新失败，其实是被逻辑删除过滤了