MyBatis-Plus更新字段为null时,update语句为null字段不生效的解决方法

文章讲述了MyBatis-Plus中遇到set为null时不生效的问题,原因在于其默认的字段策略。解决方法包括修改全局默认策略为忽略判断或在实体类注解中指定单字段策略。作者还介绍了FieldStrategy的不同类型和配置方式。

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

1.异常说明:

mapper.updateById()时, set为null 未生效,其他字段更新。


   puDeclareElements.setStatus(OrderEnum.DRAFTS.getType());
   puDeclareElements.setSubmitBy(null);
   puDeclareElementsService.updateById(puDeclareElements)
   

2.原理:

MyBatis-Plus对字段的验证策略导致的,MyBatis-Plus默认进了不是全量更新的策略,默认忽略为null 的字段的

3.解决办法:

1)修改MyBatis-Plus 全局默认策略

缺点:这样做会对所有的字段都忽略判断,如果一些字段不想要修改,但是传值的时候没有传递过来,就会被更新为null


mybatis-plus:
  global-config:
  	#字段策略 0:"忽略判断",1:"非 NULL 判断",2:"非空判断"
    field-strategy: 0

2)修改实体类注解,改变字段的忽略判断

缺点:需要注意数据库字段是否设置为 非null ,如果为非null 也更新不成功


@TableField( updateStrategy = FieldStrategy.IGNORED)
private Date settleTime;

4.字段策略全解

1)官方文档

Mybatis-Plus中FieldStrategy说明:​ ​https://baomidou.com/pages/223848/#tableid​

2)字段策略介绍​​

1、FieldStrategy作用

Mybatis-Plus字段策略FieldStrategy的作用主要是在进行新增、更新时,根据配置的策略判断是否对实体对象的值进行空值判断,如果策略为字段不能为空,则不会对为空的字段进行赋值或更新。
同样,在进行where条件查询时,根据whereStrategy策略判断是否对字段进行空值判断,如果策略为字段不能为空,则为空的字段不会作为查询条件组装到where条件中。

三个配置,对应三种使用场景

​​insertStrategy​​ : 在insert操作时的字段策略,是否进行空值判断,插入空值
​​updateStrategy : 在update操作时的字段策略,是否进行空值判断,插入空值
​​whereStrategy : ​​在where条件组装时,是否进行控制判断,将空值作为查询条件

在这里插入图片描述

2、FieldStrategy类型

FieldStrategy的源码中,一共有5种策略类型

public enum FieldStrategy {
    IGNORED,
    NOT_NULL,
    NOT_EMPTY,
    DEFAULT,
    NEVER;

    private FieldStrategy() {
    }
}

每种策略的作用

描述
IGNORED

忽略空值判断,实体对象的字段是什么值就用什么值更新,支持null值更新操作

NOT_NULL

进行非NULL判断,也是默认策略,相当于age!=null

NOT_EMPTY

进行非空判断,主要是针对字符串类型,相当于name != null and name != ‘’

NEVER

从不更新,不管字段是否有值,都不进行更新

DEFAULT

追随全局配置

3、FieldStrategy配置

① 全局策略配置

在全局配置中,三者的默认值都是​​FieldStrategy.NOT_NULL​​,即进行空值判断,不对NULL值数据进行处理。

public DbConfig() {
    this.idType = IdType.ASSIGN_ID;
    this.tableUnderline = true;
    this.capitalMode = false;
    this.logicDeleteValue = "1";
    this.logicNotDeleteValue = "0";
    this.insertStrategy = FieldStrategy.NOT_NULL;
    this.updateStrategy = FieldStrategy.NOT_NULL;
    this.whereStrategy = FieldStrategy.NOT_NULL;
}

在spring boot中可以通过配置属性修改全局字段策略:

mybatis-plus.global-config.db-config.update-strategy=not_null
mybatis-plus.global-config.db-config.insert-strategy=not_null
mybatis-plus.global-config.db-config.where-strategy=not_null
② 单字段策略配置

在实体对象中,通过​​@TableField​​注解可以针对单个字段指定字段策略。

3)实战说明

1、忽略判断-IGNORED

@TableName(value ="user")
@Data
public class User implements Serializable {
   @TableId
   private Long id;
   private String name;
   private Integer age;
   @TableField(updateStrategy = FieldStrategy.IGNORED)
   private String email;
}

再次执行上面的单元测试:

在这里插入图片描述

PS:后面就不一一举例了。可以看官网。写的很详细。

<think>我们正在使用Mybatis-Plus 3.5.3.2版本。需求是:在更新操作中,即使Date类型的字段null,也要更新到数据库中(即不忽略null值)。 在Mybatis-Plus中,默认的策略是更新忽略null值。也就是说,当我们更新一个实体,如果某个字段null,则不会将该字段更新null(即数据库中原有值保持不变)。但有我们需要将字段更新null,因此需要改变这个默认行为。 解决方案有两种: 1. 全局配置:在全局配置中设置忽略null值为false(即不忽略null值),这样所有字段更新如果为null,都会更新到数据库。 2. 字段注解:在特定字段上使用注解,指定该字段更新是否忽略null值。 但需要注意的是,全局配置会作用于所有字段,而有我们可能只希望某些字段(如Date类型)允许更新null,其他字段仍然忽略null。因此,我们可以使用字段注解来更细粒度地控制。 然而,根据Mybatis-Plus的文档,我们可以使用`@TableField`注解的`updateStrategy`属性来控制更新策略。 具体步骤: 方法一:全局配置(不推荐,因为会影响所有字段) 在配置文件中设置: mybatis-plus: global-config: db-config: update-strategy: ignored # 默认是忽略null,但这里我们想要不忽略,应该设置为not_null?实际上,全局配置中并没有直接设置不忽略null的选项,因为默认策略就是忽略null。如果我们想全局不忽略null,需要设置update-strategy为not_null?但是注意,Mybatis-Plus 3.x中,全局配置的更新策略有四个枚举值:IGNORED, NOT_NULL, NOT_EMPTY, DEFAULT(默认是NOT_NULL?实际上,在3.5.3中,全局默认策略是忽略null的,即相当于IGNORED?) 实际上,在Mybatis-Plus 3.5.3中,全局配置的更新策略(update-strategy)默认是`IGNORED`(忽略null值)。如果我们想全局不忽略null,可以设置为`NOT_NULL`,但是`NOT_NULL`的含义是只更新null字段,也就是说,如果字段null,它仍然不会更新。所以这不是我们想要的。 我们想要的是即使为null更新,那么应该设置为`IGNORED`吗?不对,因为`IGNORED`表示忽略,即不管字段是什么值都更新,包括null。所以: - IGNORED: 忽略判断,总是更新字段(不管字段值是否为null- NOT_NULL: 非NULL判断,只更新NULL字段 - NOT_EMPTY: 非空判断,只更新非空的值(注意:对于字符串,空字符串也不更新) 因此,如果我们想要更新null,应该将策略设置为`IGNORED`。但是,全局设置为`IGNORED`会导致所有字段更新(包括null和非null),这可能会带来安全风险(比如不小心将字段更新null)。 方法二:使用注解(推荐) 在Date类型的字段上,使用`@TableField`注解,并设置`updateStrategy`为`FieldStrategy.IGNORED`,这样这个字段更新就会忽略对null的判断,即使为null也会更新。 示例代码: import com.baomidou.mybatisplus.annotation.FieldStrategy; import com.baomidou.mybatisplus.annotation.TableField; public class YourEntity { @TableField(updateStrategy = FieldStrategy.IGNORED) private Date yourDateField; // ... other fields } 这样,只有这个特定的字段更新会忽略null值(即允许更新null),而其他字段仍然保持默认的更新策略(忽略null)。 注意:在Mybatis-Plus 3.5.3中,`FieldStrategy`有以下几个枚举值: - IGNORED: 忽略判断 - NOT_NULL: 非 NULL 判断 - NOT_EMPTY: 非空判断 - DEFAULT: 跟随全局配置(全局配置默认是IGNORED?实际上,全局配置的默认策略是`NOT_NULL`吗?我们需要确认一下) 根据引用[2]中的配置,我们可以看到全局配置中关于逻辑删除的配置,但并没有直接关于更新策略的全局配置默认值。根据官方文档,在3.5.3中,全局配置的更新策略默认是`NOT_NULL`(即只更新null字段)。所以,如果我们不配置全局,也不在字段上加注解,那么默认就是忽略null(即不更新null值)。 因此,我们只需要在需要更新null的Date字段上加上注解`@TableField(updateStrategy = FieldStrategy.IGNORED)`即可。 另外,如果全局配置中已经设置了更新策略,那么字段上的注解会覆盖全局配置。 总结:对于特定Date字段允许更新null,使用字段注解的方式。 但是,如果有很多Date字段都需要这样,一个一个加注解比较麻烦,那么我们可以考虑使用全局配置,将全局的更新策略设置为`IGNORED`,然后对于不需要更新null字段,再单独设置注解为`NOT_NULL`或`NOT_EMPTY`等。不过这样可能会影响其他字段,所以需要权衡。 根据我们的需求,我们只需要Date类型字段允许null更新,所以建议在Date字段上加注解。 此外,还有一个问题:在实体类中,如果字段是基本类型(如int、long等),它们不能为null,所以不会出现更新null的情况。而Date是引用类型,可以为null。 因此,我们只需要在需要更新null的Date字段上添加注解即可。 配置示例: public class User { private Long id; private String name; // 设置这个日期字段更新即使为null也要更新 @TableField(updateStrategy = FieldStrategy.IGNORED) private Date birthday; } 这样,当我们执行updateById(user),即使birthday为null,也会更新到数据库。 注意:在插入操作,也有插入策略(通过`insertStrategy`属性),如果需要,也可以单独配置。 所以,针对你的问题,解决方案是:在需要更新null的Date类型字段上添加注解`@TableField(updateStrategy = FieldStrategy.IGNORED)`。 如果全局配置已经修改,那么需要确保该字段的注解覆盖了全局配置(即设置`updateStrategy = FieldStrategy.IGNORED`)。 最后,检查一下Mybatis-Plus的版本,确保是3.5.3.2,因为不同版本可能有差异。 希望这个回答能帮到你。 引用说明: [^1]: 关于Mybatis-Plus版本升级,特别是3.4.x到3.5.x的变动,其中代码生成工具变动较大。 [^2]: 提到了全局配置和逻辑删除的配置,虽然与更新策略无关,但展示了全局配置的写法。 [^3]: 提到了多租户插件和字段重复的问题,但与本问题无关。 因此,我们主要参考了Mybatis-Plus的官方文档和常见实践。 相关问题: 1. Mybatis-Plus中如何设置插入忽略null值? 2. 除了Date类型,其他类型字段如何允许更新null? 3. 在Mybatis-Plus中,全局配置更新策略有哪些选项?分别代表什么含义?</think>### Mybatis-Plus 3.5.3.2 配置 Date 类型字段允许 null 更新Mybatis-Plus 3.5.3.2 中,默认更新策略会忽略值为 `null` 的字段(即不更新到数据库)。要使 **Date 类型字段**在更新允许 `null` 值更新,可通过以下两种方式实现: --- #### 方法一:字段级注解(推荐) 在实体类的 Date 字段上添加 `@TableField` 注解,明确指定更新策略为 `IGNORED`(不忽略任何值): ```java import com.baomidou.mybatisplus.annotation.FieldStrategy; import com.baomidou.mybatisplus.annotation.TableField; import java.util.Date; public class YourEntity { // 其他字段... @TableField(updateStrategy = FieldStrategy.IGNORED) private Date updateTime; // Date 类型字段 } ``` - **作用**:仅对该字段生效,其他字段仍遵循默认策略。 - **效果**:当 `updateTime` 为 `null` ,执行更新操作会将其置为 `null`。 --- #### 方法二:全局配置(谨慎使用) 在 `application.yml` 中修改全局更新策略,强制所有字段不忽略 `null`: ```yaml mybatis-plus: global-config: db-config: update-strategy: ignored # 全局更新策略:不忽略 null ``` - **作用**:所有字段(包括 Date 类型)在更新均会处理 `null` 值。 - **风险**:可能意外覆盖其他非 Date 字段的原始值,需评估业务影响[^1]。 --- #### ⚠️ 注意事项 1. **优先级**:字段级注解 (`@TableField`) 优先级高于全局配置。 2. **版本兼容性**:`FieldStrategy.IGNORED` 在 3.5.3.2 中有效,低版本行为可能不同[^1]。 3. **逻辑删除冲突**:若同使用 `@TableLogic` 逻辑删除,需确保两者策略不冲突[^2]。 --- #### 验证示例 ```java YourEntity entity = new YourEntity(); entity.setId(1L); entity.setUpdateTime(null); // 显式设置为 null yourEntityMapper.updateById(entity); // 成功将 update_time 更新null ``` 执行后 SQL 语句应包含:`UPDATE your_table SET update_time = null WHERE id = 1`。 --- ### 总结建议 - **推荐方案**:使用 **字段级注解** `@TableField(updateStrategy = FieldStrategy.IGNORED)`,精准控制 Date 字段行为。 - **避坑指南**:避免全局配置 `update-strategy: ignored`,除非确认所有字段均需处理 `null`[^3]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值