Mybatis-Plus更新对象时字段更新为空值的策略

最新推荐文章于 2025-10-23 09:28:01 发布
原创 最新推荐文章于 2025-10-23 09:28:01 发布 · 1.1k 阅读 · 1 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#mybatis #java

文章讨论了在使用Mybatis-Plus时遇到的一个bug，即某些字段值被置空但仍保留原值。作者发现可能的原因在于Mybatis-Plus的默认字段策略。文章介绍了如何通过`@TableField`注解的`updateStrategy`属性来处理空值更新，以及提供单字段配置、全局配置和使用`UpdateWrapper`的解决方案。

测试提了个很突然的bug，将某些字段值置为 空/null，提交保存，再次查看还是保留原来的值，第一反应不应该，基本操作系统用的是mybatis-plus，要错错就早出错的怎么会等到现在呢？奇怪了！发现了，就看看吧！

通过排查代码是没什么问题！

那就是肯能是mybatis-plus有什么特殊的地方

通过了解 com.baomidou.mybatisplus.annotation.TableField

//version 3.4.1
public @interface TableField {

    FieldStrategy insertStrategy() default FieldStrategy.DEFAULT;

    FieldStrategy updateStrategy() default FieldStrategy.DEFAULT;

    FieldStrategy whereStrategy() default FieldStrategy.DEFAULT;

    FieldFill fill() default FieldFill.DEFAULT;
}

有几个默认执行策略

FieldFill

值描述
DEFAULT默认不处理
INSERT插入时填充字段
UPDATE更新时填充字段
INSERT_UPDATE插入和更新时填充字段

FieldStrategy

值描述
IGNORED忽略该字段，不管是插入还是更新操作，都不会涉及到该字段
NOT_NULL当进行插入和更新操作时，如果该字段为 null，则会抛出异常
NOT_EMPTY当进行插入和更新操作时，如果该字段为 null 或者空字符串，则会抛出异常
DEFAULT当进行插入操作时，如果该字段为 null，则使用数据库中的默认值（如数据库字段设置了默认值）；当进行更新操作时，如果该字段为 null，则保持原有值不变
NEVER永远不处理该字段，无论是插入还是更新操作，都不会涉及到该字段

注意

3.1.2 版本后 strategy 方法被弃用，更新为 insertStrategy、updateStrategy 和 whereStrategy

/** * 字段验证策略 *

默认追随全局配置

* * @deprecated 3.1.2 , to use {@link #insertStrategy} and {@link #updateStrategy} and {@link #whereStrategy} */ @Deprecated FieldStrategy strategy() default FieldStrategy.DEFAULT;

通过上面可以参照以下方案处理 mp 执行更新操作空值的情况

方案一

单字段配置

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

单个字段比较灵活，但需要制定的很多，一般结合默认配置使用

方案二

全局配置

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

全局性配置会对所有的字段都忽略判断，如果有特殊字段处理，可以单独配置，修改字段的策略。

方案三

UpdateWrapper (3.x)

/**
 * 根据 whereEntity 条件，更新记录
 *
 * @param entity        实体对象 (set 条件值,可以为 null)
 * @param updateWrapper 实体对象封装操作类（可以为 null,里面的 entity 用于生成 where 语句）
 */
int update(@Param(Constants.ENTITY) T entity, @Param(Constants.WRAPPER) Wrapper<T> updateWrapper);


User user = new User("id", "")
mapper.update(
   Wrappers.<User>lambdaUpdate()
           .set(User::getNickName, user.getNickName())
           .eq(User::getId, user.getId())
);
跟新指定字段

一个小建议

@Tablefield 注解中有属性：fill ，字段自动填充策略

正常情况下每一张表格都有几个固定的值，如create_time （创建时间）和 update_time（更新时间），在处理这些数据的时候，每次都要手动去设置比较烦

就可以采取fill 自动填充

@TableField(value = "create_time",fill = FieldFill.INSERT)
private Date createTime;
@TableField(value = "update_time",fill = FieldFill.INSERT_UPDATE)
private Date updateTime;
猿小吧
关注
mybatis-plus 更新字段为null
学海无涯,我用JAVA
08-26 4739
mybatis-plus中的updateById 方法,正常情况下,如果设置字段为null,由于默认的字段策略,不会操作此字段,不会变为null值,那应该怎么做的? 第一种: 不推荐 上面我说了,默认的字段策略会忽略掉,所以我们可以将要设置为null 的字段的策略更改下.例如; @TableField(strategy = FieldStrategy.IGNORED) private LocalD...
Mybatis，允许更新字段为NULL
weixin_44268098的博客
04-07 3262
Data// 使用 IGNORED 策略// 不使用策略注解，将遵循全局配置。
MyBatis-plus更新为空或null
qq_40464334的博客
10-23 389
使用MyBatis-Plus更新字段为NULL时，需要注意字段验证策略。默认情况下，MyBatis-Plus会忽略null值的更新，需要通过配置或Wrapper显式指定。通过创建实体对象并设置特定字段为null，然后调用updateById方法实现更新。注意需要确保其他字段不会被意外更新为null。通过UpdateWrapper可以构建动态更新条件，并指定字段更新为NULL。在MyBatis-Plus配置中设置全局策略，允许字段更新为NULL。Lambda表达式提供了类型安全的更新方式，代码可读性更好。
Mybatis Plus 字段为空值时执行更新方法未更新解决方案
09-07
主要介绍了Mybatis Plus 字段为空值时执行更新方法未更新解决方案，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
MybatisPlus更新时会自动忽略传值为NULL的字段
weixin_43811057的博客
05-06 1万+
三种方案解决MybatisPlus更新时会自动忽略传值为NULL的字段一、背景二、解决方案2.1 使用`@TableField(updateStrategy = FieldStrategy.IGNORED)`注解添加在字段上在枚举`FieldStrategy`中有五个属性如下`updateStrategy`说明2.2 在需要修改的实体类字段上加上`@TableField(fill = FieldFill.INSERT_UPDATE)`注解`FieldFil`l枚举说明`fill`策略说明 一、背景 最近在项
Mybatis-plus 更新或新增时设置某些字段值为空
weixin_44131922的博客
05-31 2926
指定 updateStrategy = FieldStrategy.IGNORED 后会忽略该字段的空值判断，从而达到更新null的效果。通过这种方式会指定更新时该字段的策略，通常情况下updateById这种会根据字段更新，通常都会判断null 以及空值。通过updateWrapper 更新，需要手动set 字段等于 null 或 空串，以此来达到目的。通过自定义 sql，或使用原始 xml 来完成，或通过注解 都是手动写更新的语句。（一旦启用，所有通过实体更新的动作都会变化）
MyBatis-Plus中处理更新操作时的空值问题
dazhong2012的专栏
06-18 3501
MyBatis-Plus在执行更新操作时，可能会忽略字段值为空或null的情况，导致这些字段的值没有被更新为数据库中的NULL。
MyBatis-Plus 查询返回实体对象还是map
09-07
在MyBatis-Plus框架中，查询结果可以返回实体对象或Map，选择哪种方式取决于具体的应用场景和需求。MyBatis-Plus是一个基于MyBatis的扩展工具，在MyBatis的基础上只做增强不做改变，为简化开发、提高效率而生。它...
Mybatis-Plus的更新策略和MD5加密
m0_63807905的博客
02-13 224
用户的密码通常不会直接以明文的形式保存到数据库中，而是会先经过处理，然后将处理之后得到的"密文"保存到数据库，这样能够降低数据库泄漏导致的用户账号安全问题。是Apache软件基金会下的一个项目，其致力于提供可重用的开源软件，其中包含了很多易于使用的现成工具。，默认情况下，最终生成的update语句中，不会包含该字段。：进行非空判断，并进行非空串（“”）判断，主要针对字符串类型。：忽略空值判断，不管字段是否为空，都会进行更新。：从不进行更新，不管该字段为何值，都不更新。：进行非空判断，字段非空才会进行判断。
SpringBoot3整合MyBatis-Plus
m0_46496775的博客
04-21 1791
MyBatis-Plus 提供了一个 ConfigurationCustomizer 接口，允许我们在 MyBatis 的配置过程中进行自定义配置。通过实现这个接口，我们可以对 MyBatis 的 Configuration 对象进行自定义配置。在 Spring Boot 容器中放入一个 ConfigurationCustomizer 组件并实现自定义配置。在 Spring Boot 启动类中添加 @MapperScan 注解，扫描 mapper 文件夹。
【Mybatis-Plus】mybatisplus更新时，实体字段为空，数据库不更新的解决方案
No8g攻城狮的博客
12-02 1万+
mybatisplus更新时，实体字段为空，数据库不更新的解决方案
关于更新字段为空值——MybatisPlus框架
weixin_41938314的博客
03-07 2290
背景：我们在项目开发过程中，可能会经常遇到这样的问题，某个前端的字段，用户把原本有值的改为空值了，用户的意愿肯定是要去更新的，前端此时会把这个字段传"null"或空字符串，但我们后端使用框架提供的api会自动将空值跳过不去更新。优点：影响范围小，仅仅影响本方法中的更新，不会影响关于这个实体其他更新，其他更新方法该怎么更新还是怎么更新。这种方法的优点就是方便，在实体类某个/某几个字段打上如上的注解，就可以将该字段字段值为null时也更新；缺点那就是会影响所有的更新场景，关于这个实体的所有更新都会影响。
当使用mybatis plus 更新方法想将某一个字段中的值修改为空时，修改失败的解决方案
2301_79779756的博客
05-07 1935
MyBatis-Plus 是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。它提供了很多便捷的CRUD操作，包括更新（Update）方法。然而，在更新数据库记录时，可能会遇到将字段值更新为空（NULL）失败的情况。
mybatis plus 如何更新参数为空， mybatis plus update方法如何更新参数为null, update()如何设置参数=null
求是
09-09 266
MyBatis-Plus更新字段为null的三种方法：1）在Model类字段添加@TableField(updateStrategy=FieldStrategy.IGNORED)注解；2）手写SQL实现更新；3）尝试使用LambdaUpdateWrapper设置null。前两种方法确保可行，第三种方法可尝试。默认情况下MyBatis-Plus会跳过null值更新。
Mybatis-plus更新操作更新字段空值问题
m0_67392409的博客
08-29 5070
MyBatis-plus在进行更新操作时不会更新传入实体中为null或默认值属性字段，只更新不为null的值、非默认值的属性字段。/***new了一个User，只设置了token的值，根据*phone更新时不会更新其他值只会更新token*/}...
mybatisplus 修改某个字段为空值
热门推荐
weixin_47742051的博客
09-07 1万+
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档 文章目录前言一、重现bug二、解决方法2.读入数据总结 前言 需求： 移除企业；将ent_id设置为null 一、重现bug 1，使用updateById()更新单独个字段为空值，结果报错。 @Override public void update(String id,String type) { Student stu = new Student(); stu.setEntId(null
MyBatis-Plus如何将字段修改为空值
weixin_45908681的博客
03-30 5790
不推荐使用原因：相对于方案一作用范围相对较小，但调用MyBatis-Plus封装的update也会不经意将字段改为空。不推荐使用原因：作用范围太广，调用MyBatis-Plus封装的update会不经意将字段改为空。推荐原因：不影响任何地方只在此处生效。
MyBatis-Plus 更新（update）方法，属性参数为空时进行更新与不进行更新的设置
qq_43393995的博客
01-04 7627
FieldStrategy的源码中，一共有4种策略类型。在实体类上使用@TableField注解。有兴趣的小伙伴可以点击看看。
Mybatis-Plus不能更新对象字段为空值问题解决
qq_43038960的博客
07-03 6600
在实体字段上，如果不通过@TableField注解指定字段的更新策略，字段默认的更新策略是FieldStrategy.DEFAULT,即跟随全局策略。在使用Mybatis-Plus调用updateById方法进行数据更新默认情况下是不能更新空值字段的，而在实际开发过程中，往往会遇到需要将字段值更新为空值的情况，该如何解决呢？如果你不想修改全局的字段更新策略，又需要项目中某个实体的所有字段都支持空值更新，推荐采用该方法。会忽略字段的更新策略，直接对实体中的每一个字段都执行更新操作。注解指定字段的更新策略为。
mybatis-plus在写update sql时更新空值报错
最新发布
11-20
<think> 根据用户的问题，用户遇到了在使用MyBatis-Plus执行update操作时，更新空值（null或空字符串）报错的问题。用户引用的资料中提到了MyBatis-Plus默认的更新策略会忽略null值，但用户需要更新空值（包括null和空字符串）到数据库。 从引用中我们可以总结出以下几点： 1. MyBatis-Plus默认的更新策略（FieldStrategy）是NOT_NULL，即只更新非null的字段。因此，当字段值为null时，不会更新该字段。 2. 如果希望更新null值，可以通过设置字段的更新策略为IGNORED，这样无论字段值是否为null，都会更新。 3. 同样，对于空字符串，默认策略（NOT_EMPTY）也会忽略，所以也需要设置为IGNORED。 用户提到“更新空值报错”，可能的原因是在更新时，数据库表字段有非空约束，而用户试图更新为null，导致数据库报错。但根据引用内容，更常见的问题是MyBatis-Plus不会更新null值（即不会将null值更新到数据库，而不是报错）。所以，用户的问题可能是： 情况1：用户希望更新为null，但MyBatis-Plus没有更新，导致数据库字段没有变成null（用户误以为报错）。 情况2：用户确实遇到了数据库约束导致的报错（例如，字段不允许为null，但用户试图更新为null）。 但用户的问题描述是“更新空值报错”，所以重点在“报错”上。因此，我们需要考虑两种情况： A. 由于MyBatis-Plus的更新策略导致没有更新空值，而用户期望更新空值，但数据库字段有非空约束，当用户更新为空值（null或空字符串）时，数据库报错（因为数据库约束不允许为空）。 B. 用户配置了更新策略为IGNORED，使得MyBatis-Plus会将null值更新到数据库，但数据库字段不允许为null，因此报错。 然而，根据引用内容，更可能的情况是：用户希望更新空值（包括null），但MyBatis-Plus默认不更新null值，所以用户需要改变更新策略。但是，如果数据库字段不允许为null，那么即使MyBatis-Plus更新了，也会触发数据库约束错误。 因此，解决步骤应该是： 1. 确认数据库表字段是否允许为null。如果字段不允许为null，那么更新为null就会报错，这时应该检查业务逻辑，不应该更新为null。 2. 如果数据库字段允许为null，那么需要配置MyBatis-Plus的更新策略，使其可以更新null值和空字符串。 根据引用，配置更新策略的方法有两种： - 全局配置：在application.yml（或application.properties）中设置 - 局部配置：在实体类的字段上使用注解@TableField 具体做法如下： 全局配置（适用于所有字段）： 在配置文件中（如application.yml）设置： ```yaml mybatis-plus: global-config: db-config: update-strategy: ignored # 低版本可能是 field-strategy ``` 注意：高版本（3.4.0+）中，属性名为`update-strategy`，低版本可能是`field-strategy`。另外，全局设置会作用于所有字段，可能会带来安全隐患（比如无意中将某些不允许为空的字段更新为null）。 局部配置（仅对特定字段）： 在实体类的字段上添加注解： ```java @TableField(updateStrategy = FieldStrategy.IGNORED) private String name; ``` 这样，该字段就会忽略空值判断，即使为null或空字符串也会更新。 另外，如果用户需要更新空字符串，默认策略（NOT_EMPTY）也会忽略空字符串，所以同样需要设置IGNORED策略。 但是，用户提到“报错”，所以可能还需要考虑数据库约束问题。如果数据库字段有非空约束，那么即使MyBatis-Plus执行了更新（即生成了更新为null的SQL），数据库也会报错。因此，在更新为null之前，需要确保数据库字段允许为null。 总结解决方案： 1. 检查数据库表结构，确保要更新为null或空字符串的字段允许为空。 2. 配置MyBatis-Plus的更新策略为IGNORED（全局或局部），以便更新null和空字符串。 如果数据库字段不允许为null，那么不能更新为null，否则会报错。此时应调整业务逻辑，避免更新为null，或者修改数据库表结构（如果允许）使其可为null。 注意：引用中提到的报错可能是由于数据库约束导致的，而不是MyBatis-Plus本身报错。因此，需要从两个方面入手：数据库约束和MyBatis-Plus更新策略。 最后，根据引用内容，用户可能混淆了“更新后数据库还是原来的值”（因为MyBatis-Plus忽略更新）和“报错”。但用户明确说了“报错”，所以我们优先考虑数据库约束导致的错误。 因此，回答应该包括： - 检查数据库表结构，确认字段是否允许为null。 - 配置MyBatis-Plus更新策略，使其可以更新null和空字符串（如果数据库允许）。 - 如果数据库不允许为null，则不能更新为null，需要调整业务逻辑或修改表结构。 同时，提供配置示例。 </think>### MyBatis-Plus 更新空值报错的解决方案 在使用 MyBatis-Plus 执行 `update` 操作时，若遇到空值（`null` 或空字符串）更新报错，核心原因是 **MyBatis-Plus 的字段更新策略（FieldStrategy）** 与数据库约束冲突。以下是详细解决方案： --- ### 一、问题根本原因 1. **MyBatis-Plus 默认更新策略** 默认采用 `FieldStrategy.NOT_NULL` 策略：若字段值为 `null`，则忽略该字段，不生成更新 SQL。 $$ \text{更新SQL} = \begin{cases} \text{包含字段} & \text{值} \neq \text{null} \\ \text{忽略字段} & \text{值} = \text{null} \end{cases} $$ 2. **报错场景** 当主动需要将字段更新为 `null` 或空字符串时： - 若未修改更新策略 → MyBatis-Plus 忽略该字段 → **数据库保留旧值**（非报错） - 若配置策略为 `IGNORED`，但数据库字段有 **非空约束** → 执行 SQL 时报错（如 `Column 'xxx' cannot be null`） --- ### 二、解决方案（按优先级推荐） #### ✅ 方案1：修改字段更新策略（推荐） 在实体类字段上添加注解，强制更新空值： ```java public class User { @TableField(updateStrategy = FieldStrategy.IGNORED) // 忽略空值判断 private String name; } ``` - **效果**：无论字段值是否为 `null` 或空字符串，均会生成更新 SQL。 - **注意**：需确保数据库字段允许为 `null`，否则需同步修改表结构。 #### ✅ 方案2：全局配置更新策略 在 `application.yml` 中全局设置： ```yaml mybatis-plus: global-config: db-config: update-strategy: ignored # 全局忽略空值判断 ``` - **适用场景**：所有实体类字段均需支持空值更新。 - **风险**：可能意外覆盖不应为空的字段。 #### ✅ 方案3：自定义 SQL 语句 在 Mapper 接口中使用自定义 SQL： ```xml <!-- UserMapper.xml --> <update id="updateWithNull"> UPDATE user SET name = #{name}, age = #{age} <!-- 显式指定所有字段 --> WHERE id = #{id} </update> ``` ```java // Java 调用 userMapper.updateWithNull(user); // 手动控制更新逻辑 ``` - **优势**：完全绕过 MyBatis-Plus 的更新策略限制。 --- ### 三、避坑指南 1. **数据库约束检查** 执行空值更新前，确认目标字段是否允许为 `null`： ```sql SHOW CREATE TABLE user; -- 检查字段的 NULL 约束 ``` 若字段有 `NOT NULL` 约束，需先修改表结构： ```sql ALTER TABLE user MODIFY COLUMN name VARCHAR(255) NULL; ``` 2. **版本兼容性** - MyBatis-Plus ≥ 3.4.0：使用 `@TableField(updateStrategy)` - MyBatis-Plus < 3.4.0：使用 `@TableField(strategy = FieldStrategy.IGNORED)` 3. **批量更新策略** 使用 `updateBatchById()` 时，需为 **每个字段** 单独配置 `updateStrategy`。 --- ### 总结流程 ```mermaid graph TD A[遇到空值更新报错] --> B{数据库字段是否允许为空？} B -->|是| C[配置字段策略为 IGNORED] B -->|否| D[修改数据库字段约束] D --> C C --> E[重新执行更新操作] ``` 通过调整更新策略或数据库约束，即可解决空值更新报错问题。优先推荐**方案1**，安全性更高[^1][^2][^3]。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值