Mybatis-Plus updateById方法更新无效及空值处理过程

 更新时间:2025年07月15日 09:41:18   作者:秋分的秋刀鱼  
MyBatis-Plus的updateById默认不更新null值以防止误操作,可通过UpdateWrapper/LambdaUpdateWrapper显式设置,或全局配置、注解@TableField允许字段更新为空,需根据业务场景选择合适方式

在使用 Mybatis-Plus 进行数据持久化操作时,updateById 方法默认不会更新字段的空值(null)。

这是因为 Mybatis-Plus 为了防止误操作,避免将数据库中原本存在的非空字段更新为 null。然而,在某些业务场景下,我们可能需要允许更新空值。

以下是几种解决 updateById 方法不更新空值或更新字段无效问题的方法:

1. 使用UpdateWrapper并设置setSqlSelect

通过 UpdateWrapper 可以灵活地控制更新的字段,包括允许更新为 null

import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper;

// 假设有一个实体类 User
User user = new User();
user.setId(1); // 需要更新的记录ID
user.setName(null); // 需要更新为空的字段
user.setAge(30);

UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", user.getId())
             .set("name", user.getName()) // 允许 name 字段更新为 null
             .set("age", user.getAge());

int rows = userMapper.update(null, updateWrapper);
System.out.println("受影响的行数: " + rows);

2. 使用LambdaUpdateWrapper并调用set方法

LambdaUpdateWrapper 提供了类型安全的更新方式,同样可以设置字段为 null

import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;

User user = new User();
user.setId(1);
user.setName(null); // 需要更新为空的字段
user.setAge(30);

LambdaUpdateWrapper<User> lambdaUpdate = new LambdaUpdateWrapper<>();
lambdaUpdate.eq(User::getId, user.getId())
           .set(User::getName, user.getName()) // 允许 name 字段更新为 null
           .set(User::getAge, user.getAge());

int rows = userMapper.update(null, lambdaUpdate);
System.out.println("受影响的行数: " + rows);

3. 全局配置允许更新空值

如果项目中多处需要更新空值,可以在 Mybatis-Plus 的全局配置中开启 updateStrategy,允许字段更新为 null

mybatis-plus:
  global-config:
    db-config:
      update-strategy: not_null # 默认值,可以设置为 'ignore' 以允许更新 null

或者在代码中进行配置:

import com.baomidou.mybatisplus.annotation.DbConfig;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 其他拦截器配置
        return interceptor;
    }

    @Bean
    public DbConfig dbConfig() {
        return new DbConfig();
    }
}

注意:全局配置会影响所有的更新操作,需谨慎使用。

4. 使用UpdateStrategy注解

在实体类的字段上使用 @TableField 注解,并设置 updateStrategyFieldStrategy.IGNORED,以允许该字段在更新时接受 null 值。

import com.baomidou.mybatisplus.annotation.FieldStrategy;
import com.baomidou.mybatisplus.annotation.TableField;

public class User {
    
    private Long id;
    
    @TableField(updateStrategy = FieldStrategy.IGNORED)
    private String name; // 允许更新为 null
    
    private Integer age;

    // getters and setters
}

5. 检查实体类的属性和数据库字段映射

确保实体类中的属性名称与数据库表中的字段名称一致,且类型匹配。

如果存在不一致,可能导致更新无效。

6. 确认事务是否生效

如果在一个事务中进行更新操作,确保事务已正确提交。

未提交的事务不会对数据库产生影响。

import org.springframework.transaction.annotation.Transactional;

@Service
public class UserService {

    @Transactional
    public void updateUser(User user) {
        userMapper.updateById(user);
    }
}

总结

updateById 方法默认不更新空值是为了防止误操作。

如果确实需要更新空值,可以通过以下几种方式实现:

  1. 使用 UpdateWrapperLambdaUpdateWrapper 并显式设置需要更新的字段为 null
  2. 在全局配置中调整更新策略(需谨慎)。
  3. 在实体类字段上使用注解 @TableField 并设置 updateStrategyIGNORED
  4. 确认实体类与数据库字段的映射关系以及事务的正确性。

根据具体的业务需求选择合适的方法,以确保数据更新操作符合预期。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • SpringBoot中整合JodConverter实现文件在线预览功能

    SpringBoot中整合JodConverter实现文件在线预览功能

    Spring Boot JodConverter是一个基于Spring Boot框架的文档转换工具,它使用JodConverter库来实现文档格式之间的转换,本文主要介绍了SpringBoot中整合JodConverter实现文件在线预览功能,需要的朋友可以参考下
    2024-04-04
  • 如何配置feign全局log

    如何配置feign全局log

    这篇文章主要介绍了如何配置feign全局log,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-06-06
  • 解析Java图形化编程中的文本框和文本区

    解析Java图形化编程中的文本框和文本区

    这篇文章主要介绍了Java图形化编程中的文本框和文本区,是Java入门学习中的基础知识,需要的朋友可以参考下
    2015-10-10
  • 如何通过Java实现时间轴过程解析

    如何通过Java实现时间轴过程解析

    这篇文章主要介绍了如何通过Java实现时间轴过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-02-02
  • Java中的functor实现

    Java中的functor实现

    Java中的functor实现...
    2006-12-12
  • spring之Bean的生命周期详解

    spring之Bean的生命周期详解

    本篇文章主要介绍了spring之Bean的生命周期详解,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • Spring如何实现输出带动态标签的日志

    Spring如何实现输出带动态标签的日志

    文章介绍了如何通过动态标签日志实现,解决了部分业务代码在多个模块中调用时日志无法直观看出来源的问题,主要通过ThreadLocal存储业务标签,并在日志输出时插入该标签,实现日志的动态标签功能,感兴趣的朋友一起看看吧
    2024-12-12
  • 解决执行maven命令时提示Process terminated的问题

    解决执行maven命令时提示Process terminated的问题

    这篇文章主要介绍了解决执行maven命令时提示Process terminated的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • Spring实战之@Autowire注解用法详解

    Spring实战之@Autowire注解用法详解

    这篇文章主要介绍了Spring实战之@Autowire注解用法,结合实例形式详细分析了Spring @Autowire注解具体实现步骤与相关使用技巧,需要的朋友可以参考下
    2019-12-12
  • Java pdf文件书签承前缩放验证的设置方法

    Java pdf文件书签承前缩放验证的设置方法

    很多朋友不知道是什么是书签承前缩放,简单说就是可以任意改变当前pdf文档缩放比例,点击书签后不影响其缩放比率,本文给大家介绍下Java pdf文件书签承前缩放验证的设置方法,感兴趣的朋友一起看看吧
    2022-02-02

最新评论