Mybatis Plus字段为空值时未更新问题及解决

在使用MyBatis Plus进行开发时，不少开发者会遇到一个典型问题：调用updateById()方法时，明明从前台传入的某个字段值为空（null或空字符串），但执行后数据库里该字段却没有被更新，仍然保持着旧值。这让人不禁疑惑，以前用原生MyBatis时，生成的更新方法通常会判断值是否为空，为空则不拼接到SQL语句中。那么，MyBatis Plus作为一款增强工具，是否也提供了类似@TableField、@TableId这样的注解来解决这个问题呢？

方案一：注解方式

答案就在@TableField注解里。仔细查看这个注解的属性，你会发现一个名为fill的字段，它专门用来定义字段自动填充策略。

这个策略决定了在执行插入（insert）或更新（update）操作时，被注解的字段该如何处理。FieldFill枚举提供了几种选项：

问题的关键就在于默认值DEFAULT。它意味着“不处理”，这正是导致我们开头所述问题的原因——当字段值为空时，MyBatis Plus默认不会将其纳入更新语句。生成的SQL可能像这样：

update shop_item set shop_price = ? where id = ?;
-- 而如果shop_price传入的是null或空字符串，这个set子句可能就不会被加入。

那么，如何解决呢？我们可以在实体类的对应字段上，通过fill属性明确指定更新时的策略。看一个例子：

@Data
@TableName("shop_item")
public class ShopItem implements Serializable {
 
    private static final long serialVersionUID = 1L;
 
    /**
     * 编号
     */
    @TableId(type= IdType.INPUT)
    private String id;
 
    /**
     * 物品名称
     */
    private String itemName;
 
    /**
     * 物品价格
     */
    @TableField(fill = FieldFill.UPDATE)
    private Double itemPrice;
 
    /**
    *    添加人编号
    */
    private String addUserId;
 
    /**
    *    添加时间
    */
    private Date addTime;
}

我们在itemPrice属性上添加了@TableField(fill = FieldFill.UPDATE)。这等于告诉MyBatis Plus：“在执行更新操作时，请务必处理这个字段，即使它传进来的是空值。”这样一来，执行的SQL就会包含这个字段了：

update 
    shop_item 
set 
    item_name = 'iPhone',
    item_price = '' -- 注意，这里即使传入空值也会被拼接到SQL中
where 
id = '361E8C48-6699-4ED5-83C4-7C9D98747C2C';

当然，这里需要配套实现一个MetaObjectHandler来定义具体如何“填充”这个空值（例如，是设置为null，还是某个默认值），但这已属于另一个话题——字段自动填充机制。本方案的核心在于利用fill属性让字段参与更新过程。

方案二：全局配置

除了在单个字段上注解，MyBatis Plus还提供了全局配置的方式。这涉及到FieldStrategy的三种策略：IGNORED（忽略判断，始终更新）、NOT_NULL（非NULL则更新）、NOT_EMPTY（非空则更新）。

你可以在项目的application.yml（或application.properties）配置文件中，通过修改全局配置来改变默认的更新策略：

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

将update-strategy设置为IGNORED后，全局所有字段在执行更新时都会忽略空值判断，即空值也会被更新到数据库。这种方法的好处是一劳永逸，省去了为每个字段添加注解的麻烦。

但需要注意的是，全局配置的影响范围也是全局的。如果你只是某些特定字段需要更新空值，而其他字段希望保持非空才更新的逻辑，那么全局配置可能就不太合适。此时，你依然可以在特定字段上使用@TableField注解来覆盖全局策略。

方案三：使用 UpdateWrapper 进行更新

如果你觉得修改实体类注解或全局配置的影响面太大，那么UpdateWrapper或许是一个更灵活、更精细的选择。这是MyBatis Plus 3.x版本中提供的一个强大工具。

查看BaseMapper的update方法签名：

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

关键点在于，这里的entity参数可以为null，而更新字段可以通过UpdateWrapper来动态指定。这给了我们两种实现思路：

• 将需要更新的字段及其新值，通过set方法设置到UpdateWrapper中。
• 或者，将需要更新的字段设置到entity对象里，再传入UpdateWrapper构建查询条件。

使用Lambda表达式，代码可以写得非常清晰：

// 示例：将id为2的用户的age更新为3，name更新为"mp"，同时将email明确更新为null
mapper.update(
    null, // 实体对象设为null，所有更新字段通过wrapper指定
    Wrappers.lambdaUpdate()
       .set(User::getAge, 3)
       .set(User::getName, "mp")
       .set(User::getEmail, null) // 明确将email字段更新为null
       .eq(User::getId, 2)
);

这种方法的最大优点是影响范围最小，完全在方法级别控制。你可以精确地决定本次更新要包含哪些字段，以及它们的值是什么，完全不受实体类注解或全局配置的约束。对于处理一些特殊的、一次性的更新逻辑非常有用。

总结

面对MyBatis Plus中空字段不更新的问题，我们实际上有三个层次的解决方案：

1. 注解方式（@TableField）：最为精准，在实体字段级别控制更新行为，适合对特定字段有明确更新策略的场景。
2. 全局配置：最为便捷，通过配置文件一键修改所有字段的默认更新策略，适合项目整体策略统一的场景，但要注意其全局影响力。
3. UpdateWrapper方式：最为灵活，在代码中动态构造更新语句，可以精确控制单次操作的更新字段，适合复杂或临时的更新逻辑。

在实际开发中，可以根据具体的业务需求、团队规范和场景复杂度，选择最合适的一种或组合使用。理解每种方案背后的机制，能帮助我们在遇到类似问题时，更加游刃有余地找到最佳实践。