MyBatis-Plus更新字段为null的三种解决方案_开发_开发者

开发者 https://www.devze.com 2025-10-11 10:26 出处：网络作者：一勺菠萝丶

目录问题示例方案 1：修改实体类策略，让 null 也更新方案 2：使用 UpdateWrapper 或 LambdaUpdateWrapper 动态更新方案 3：自定义 Mapper SQL小结总结在使用 MyBATis-Plus 进行数据库更新时，很多小伙伴会遇到一个问

问题示例

假设我们有一个更新方法：

@Override
@Transactional(rollbackFor = Exception.class)
public void updateCarousel(@Valid CarouselUpdateReqVO updateReqVO) {
    // 校验记录存在
    validateCarouselExists(updateReqVO.getId());

    // 转换实体类
    CarouselDO updateObj = BeanUtils.toBean(updateReqVO, CarouselDO.class);

    // 更新数据库
    carouselMapper.updateById(updateObj);
}

如果 updateReqVO.getLinkId() 为 null，执行 updateById 后，link_id 不会被更新，数据库值不会变成 null。

这是 MyBatis-Plus 默认策略导致的，它默认 忽略 null 值字段。

方http://www.devze.com案 1：修改实体类策略，让 null 也更新

MyBatis-Plus 提供了 @TableField(updateStrategy = FieldStrategy) 来控制字段更新策略。

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

@TableField(updateStrategy = FieldStrategy.ALWAYS)
private Long linkId;

策略说明：

策略	作用
ALWAYS	永远更新，即使字段为 null，也会更新到数据库
NOT_NULL	默认值，字段为 null 时不会更新
NOT_EMPTY	字符串类型使用，空字符串也会忽略
NEVER	永不更新
DEFAULT	使用全局默认策略

如果字段使用 ALWAYS，当你传 null 时，就会把数据库字段置空。

优点：简单直接，只javascript需改实体类。

缺点：全局生效，可能影响其它更新场景。

方案 2：使用 UpdateWrapper 或 LambdaUpdateWrapper 动态更新

如果你只想在某次更新操作中支持 null 更新，而不改实体类，可以手动构建更新条件：

CarouselDO updateObj = BeanUtils.toBean(updateReqVO, CarouselDO.class);

LambdaUpdateWrapper<CarouselDO> wrapper = new LambdaUpdateWrapper<>();
wrapper.eq(CaroupythonselDO::getId, updateObj.getId())
       .set(CarouselDO::getLinkId, updateObj.getLinkId()); // null 也可以更新

carouselMapper.update(null, wrapper);

或者使用普通 UpdateWrapper：

UpdateWrapper<CarouselDO> updateWrapper = new UpdateWrapper<>();
updateWrapper.eq("id", updateObj.getId())
             .set("link_id", updateObj.getLinkId()); // null 也可以更新

carouselMapper.update(updateObj, updateWrapper);

优点：灵活，只针对当前更新操作生效。

缺点：字段较多时，需要手动写每个字段。

方案 3：自定义 Mapper SQL

当字段较多或者更新规则复杂时，可以直接写自定义 SQL：

<update id="updateCarousel">
    update carousel
    set
        link_id = #{linkId},
        title = #{title},
        description = #{description}
    where id = #{id}
</update>

完全控制字段更新规则，包括 null 值编程客栈。

失去 MyBatis-Plus 自动映射便利。

小结

方案	优点	缺点	适用场景
实体类设置 ALWAYS	简单，全局生效	影响所有更新操作	字段允许全局置空
LambdaUpdateWrapper / UpdateWrapper	灵活，针对单次操作	写法稍复杂	单次更新可能置空字段
自定义 Mapper SQL	完全控制，适合复杂场景	失去自动映射	批量或复杂更新