MyBatis-Plus字段更新策略解析与最佳实践-代码聚汇网

MyBatis-Plus字段更新策略解析与最佳实践

Nicholas Qin

markdown复制## 1. 问题背景与现象解析

最近在项目中使用MyBatis-Plus进行开发时，发现一个有意思的现象：当更新实体对象时，如果某些字段值为null，这些字段不会被更新到数据库。这个设计其实源于MyBatis-Plus的字段策略（FieldStrategy），默认情况下它会忽略null值的字段更新。

举个例子，假设我们有个User实体：

```java
public class User {
    private Long id;
    private String username;
    private Integer age;
    // getters and setters
}

当我们执行如下更新操作时：

java复制User user = new User();
user.setId(1L);
user.setUsername(null); // 显式设置为null
userMapper.updateById(user);

你会发现数据库中的username字段并没有被更新为null，而是保持了原来的值。这个特性在实际业务中可能会带来一些困扰，特别是当我们需要显式地将某个字段置为null时。

2. MyBatis-Plus字段更新策略解析

2.1 字段策略的三种类型

MyBatis-Plus通过FieldStrategy枚举类定义了三种字段更新策略：

IGNORED：忽略判断，无论字段是否为null都会更新
NOT_NULL：非null判断，只更新非null值（默认策略）
NOT_EMPTY：非空判断，对于字符串还会检查是否为empty("")

2.2 默认策略的影响

默认的NOT_NULL策略会导致以下行为：

当字段值为null时，该字段不会出现在UPDATE语句中
数据库会保留该字段的原有值
这在大多数情况下是合理的，可以避免意外覆盖

2.3 策略的应用范围

这些策略可以配置在三个层面：

全局配置：影响所有实体
实体类级别：通过@TableField注解配置
字段级别：针对特定字段配置

3. 四种解决方案详解

3.1 方案一：全局配置策略为IGNORED

在MyBatis-Plus的配置类中设置全局策略：

java复制@Configuration
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        return interceptor;
    }
    
    @Bean
    public GlobalConfig globalConfig() {
        GlobalConfig globalConfig = new GlobalConfig();
        GlobalConfig.DbConfig dbConfig = new GlobalConfig.DbConfig();
        dbConfig.setUpdateStrategy(FieldStrategy.IGNORED);
        globalConfig.setDbConfig(dbConfig);
        return globalConfig;
    }
}

适用场景：

整个项目都需要更新null值
不需要区分字段的特殊处理

注意事项：

这样配置后，所有字段都会更新，包括null值
可能会意外覆盖某些不想更新的字段
建议配合@TableField注解在特定字段上覆盖全局设置

3.2 方案二：使用@TableField注解指定策略

在实体类的特定字段上使用注解：

java复制public class User {
    @TableField(updateStrategy = FieldStrategy.IGNORED)
    private String username;
    
    // 其他字段...
}

适用场景：

只需要特定字段支持null值更新
其他字段保持默认策略

优势：

粒度更细，控制更精准
不影响其他字段的默认行为

注意事项：

需要明确知道哪些字段需要特殊处理
如果字段较多，注解会比较繁琐

3.3 方案三：使用UpdateWrapper明确指定更新字段

通过UpdateWrapper来精确控制更新哪些字段：

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

适用场景：

需要动态决定更新哪些字段
需要更灵活的控制逻辑

优势：

完全掌控SQL生成
可以基于条件动态构建更新语句

注意事项：

代码量相对较多
需要手动维护字段名，容易出错

3.4 方案四：使用LambdaUpdateWrapper（推荐）

结合Lambda表达式，更安全地构建更新条件：

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

优势：

类型安全，IDE可以自动补全
编译时检查，避免字段名拼写错误
代码更简洁易读

最佳实践：

对于复杂更新逻辑，优先使用此方案
结合业务条件动态构建wrapper

4. 各方案对比与选型建议

4.1 方案对比表

方案	配置复杂度	灵活性	安全性	适用场景
全局配置	低	低	低	整个项目都需要更新null值
@TableField	中	中	高	特定字段需要特殊处理
UpdateWrapper	高	高	中	需要动态构建更新逻辑
LambdaUpdateWrapper	高	高	高	类型安全的动态更新

4.2 选型建议

简单项目：如果项目简单，字段不多，可以使用@TableField注解
复杂业务：对于复杂业务逻辑，推荐使用LambdaUpdateWrapper
历史项目：如果是改造历史项目，可以先用全局配置快速解决问题
新项目：新项目建议结合使用@TableField和LambdaUpdateWrapper

5. 常见问题与解决方案

5.1 为什么我的null值更新不生效？

可能原因：

没有正确配置更新策略
使用了自动填充字段（如createTime）
字段名与数据库列名映射不正确

解决方案：

检查全局和字段级别的策略配置
确认没有@TableField(fill = FieldFill.INSERT_UPDATE)等自动填充注解
检查字段名与数据库列名的映射关系

5.2 如何部分字段保持默认策略，部分字段允许null更新？

可以采用混合策略：

全局保持默认的NOT_NULL策略
在需要更新null的字段上添加@TableField(updateStrategy = FieldStrategy.IGNORED)

5.3 使用UpdateWrapper时需要注意什么？

关键点：

字段名要确保正确，建议使用Lambda方式避免拼写错误
注意条件构造，避免全表更新
对于String类型的null值，需要使用set(null)而不是set("null")

5.4 性能优化建议

避免频繁创建UpdateWrapper对象，可以复用
对于批量更新，考虑使用executeBatch
复杂更新可以考虑直接使用自定义SQL

6. 深入原理：MyBatis-Plus的SQL生成机制

6.1 更新SQL的生成流程

实体对象属性检查
根据FieldStrategy过滤字段
构建SET子句
添加WHERE条件

6.2 关键源码分析

在DefaultSqlInjector中，更新方法的实现会调用FieldStrategy的判断逻辑：

java复制// 简化后的核心逻辑
if (fieldStrategy != FieldStrategy.IGNORED) {
    if (fieldStrategy == FieldStrategy.NOT_NULL && value == null) {
        continue; // 跳过null值字段
    }
    if (fieldStrategy == FieldStrategy.NOT_EMPTY && (value == null || (value instanceof CharSequence && ((CharSequence) value).length() == 0))) {
        continue; // 跳过null或empty字段
    }
}
// 添加字段到SET子句

6.3 设计思想解读

MyBatis-Plus的这种设计有几个优点：

防止意外覆盖：避免前端传null导致数据丢失
减少不必要更新：提升性能
灵活性：可以通过多种方式覆盖默认行为

7. 实际项目中的最佳实践

7.1 分层架构中的处理建议

Controller层：保持DTO的纯净，不做策略处理
Service层：根据业务需要决定是否转换null值
DAO层：通过配置或Wrapper控制最终SQL生成

7.2 与前端交互的注意事项

明确约定字段更新语义
对于null值要有明确的业务含义
考虑使用PATCH而不是PUT进行部分更新

7.3 监控与日志

记录重要字段的更新历史
对敏感字段的null值更新添加审计日志
监控异常的大量null值更新

8. 扩展思考：null值处理的哲学

在实际开发中，null值的处理一直是个有争议的话题。MyBatis-Plus的默认策略实际上反映了一种保守的设计哲学：宁愿不做，也不要犯错。这与许多ORM框架的设计理念是一致的。

对于关键业务字段，建议：

尽量避免设计可为null的字段
使用默认值代替null
对于必须为null的情况，要有明确的文档说明

在微服务架构中，null值的传递更需要特别注意：

跨服务调用时，明确null的语义
考虑使用Optional等包装类型
协议层要区分"字段未设置"和"字段显式设置为null"

最后，无论采用哪种方案，最重要的是团队内部要保持一致。在项目开始阶段就应该明确null值的处理规范，避免后期出现混乱。

MyBatis-Plus字段更新策略解析与最佳实践

2. MyBatis-Plus字段更新策略解析

2.1 字段策略的三种类型

2.2 默认策略的影响

2.3 策略的应用范围

3. 四种解决方案详解

3.1 方案一：全局配置策略为IGNORED

3.2 方案二：使用@TableField注解指定策略

3.3 方案三：使用UpdateWrapper明确指定更新字段

3.4 方案四：使用LambdaUpdateWrapper（推荐）

4. 各方案对比与选型建议

4.1 方案对比表

4.2 选型建议

5. 常见问题与解决方案

5.1 为什么我的null值更新不生效？

5.2 如何部分字段保持默认策略，部分字段允许null更新？

5.3 使用UpdateWrapper时需要注意什么？

5.4 性能优化建议

6. 深入原理：MyBatis-Plus的SQL生成机制

6.1 更新SQL的生成流程

6.2 关键源码分析

6.3 设计思想解读

7. 实际项目中的最佳实践

7.1 分层架构中的处理建议

7.2 与前端交互的注意事项

7.3 监控与日志

8. 扩展思考：null值处理的哲学

内容推荐