mybatis plus如何更新字段为null

# MyBatis Plus如何更新字段为null

## 前言

在日常开发中，我们经常会遇到需要将数据库中的某些字段更新为NULL值的场景。然而，在使用MyBatis Plus这一强大的ORM框架时，开发者可能会发现直接设置实体类字段为null并不能如愿更新数据库中的对应字段为NULL。本文将深入探讨这一问题的原因，并提供多种解决方案。

## 问题现象

先看一个典型的问题示例：

```java
User user = new User();
user.setId(1L);
user.setUsername(null); // 希望将username更新为null
userMapper.updateById(user);

执行上述代码后，会发现数据库中的username字段并没有被更新为NULL，而是保持了原来的值。

问题原因

MyBatis Plus默认采用了字段非空检测机制，其底层实现逻辑是：

1. 在生成UPDATE语句时，只会包含非NULL的字段
2. 如果字段值为NULL，则该字段不会被包含在UPDATE语句中
3. 这种设计主要是为了避免意外覆盖字段值

解决方案

方案一：使用UpdateWrapper

最直接的方式是使用UpdateWrapper来构建更新条件：

UpdateWrapper<User> updateWrapper = new UpdateWrapper<>();
updateWrapper.set("username", null)
             .eq("id", 1L);
userMapper.update(null, updateWrapper);

优点： - 简单直接 - 无需修改全局配置 - 精确控制要更新的字段

缺点： - 需要手动编写字段名（字符串形式）

方案二：使用@TableField注解

在实体类字段上添加@TableField注解并设置update属性：

public class User {
    @TableField(update = "null")
    private String username;
    // 其他字段...
}

然后执行更新：

User user = new User();
user.setId(1L);
user.setUsername(null);
userMapper.updateById(user);

注意：这种方式会将字段始终更新为NULL，可能不符合某些业务场景。

方案三：全局配置策略

修改MyBatis Plus的全局配置（在application.yml中）：

mybatis-plus:
  global-config:
    db-config:
      logic-not-delete-field: # 逻辑未删除字段名
      logic-delete-field: # 逻辑删除字段名
      insert-strategy: not_empty
      update-strategy: ignored

策略选项说明： - not_null：非NULL判断 - not_empty：非空判断（对字符串还会检查是否为空串） - ignored：忽略判断，始终更新 - default：跟随全局配置

方案四：使用LambdaUpdateWrapper

Java 8+推荐使用类型安全的Lambda表达式：

LambdaUpdateWrapper<User> lambdaUpdateWrapper = new LambdaUpdateWrapper<>();
lambdaUpdateWrapper.set(User::getUsername, null)
                  .eq(User::getId, 1L);
userMapper.update(null, lambdaUpdateWrapper);

优点： - 类型安全 - 编译时检查 - 支持代码提示

方案五：自定义SQL

对于复杂场景，可以直接编写SQL：

@Update("UPDATE user SET username = NULL WHERE id = #{id}")
int setUsernameToNull(@Param("id") Long id);

方案六：使用MetaObjectHandler

实现MetaObjectHandler接口自定义字段填充策略：

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "username", String.class, null);
    }
}

性能考量

不同方案在性能上的差异：

1. UpdateWrapper：中等性能，需要解析Wrapper
2. 注解方式：高性能，但不够灵活
3. 全局配置：影响范围大，需谨慎
4. 自定义SQL：最高性能，但维护成本高

最佳实践建议

1. 简单场景：优先使用UpdateWrapper或LambdaUpdateWrapper
2. 需要类型安全：选择LambdaUpdateWrapper
3. 特定字段处理：使用@TableField注解
4. 批量处理：考虑自定义SQL提升性能
5. 全局策略：在项目初期确定好策略

常见问题解答

Q1：为什么我的NULL值更新不生效？

A：检查是否配置了更新策略，默认情况下MyBatis Plus会忽略NULL值。

Q2：如何只更新部分字段为NULL？

A：使用UpdateWrapper精确指定要更新的字段。

Q3：全局配置和注解方式哪个优先级更高？

A：注解方式的优先级高于全局配置。

Q4：使用Lambda表达式有什么优势？

A：类型安全、编译时检查、更好的IDE支持。

源码解析

MyBatis Plus更新逻辑的核心在AbstractWrapper和SqlInjector中。关键代码片段：

// com.baomidou.mybatisplus.core.conditions.AbstractWrapper
protected String formatSqlMaybeWithNull(String column, Object val) {
    if (val == null) {
        return column + " = NULL";
    }
    return formatSql(column, val);
}

版本兼容性

不同MyBatis Plus版本的处理方式：

• 3.0-3.4：主要使用@TableField和全局配置
• 3.5+：增强了对Lambda的支持
• 最新版：推荐使用LambdaUpdateWrapper

总结

MyBatis Plus更新字段为NULL有多种实现方式，开发者应根据具体场景选择最合适的方案。理解框架的默认行为并掌握这些技巧，可以显著提高开发效率和代码质量。

扩展阅读

1. MyBatis Plus官方文档 - 条件构造器
2. MyBatis Plus字段策略详解
3. ORM框架中的NULL值处理最佳实践

”`

这篇文章共计约2400字，涵盖了MyBatis Plus更新字段为NULL的各种解决方案、原理分析、性能考量和最佳实践，采用Markdown格式编写，包含代码示例和结构化标题。