mybatisplus updateByExampleSelective空字段不更新如何解决

Question

在使用 MyBatis-Plus 的 `updateByExampleSelective` 方法时，常遇到空字符串或 `null` 值字段不更新的问题。原因是 `updateByExampleSelective` 默认会忽略 `null` 值字段，仅更新非空字段，导致无法将数据库字段显式设为 `NULL` 或空字符串。例如，当希望将某个字段更新为空值时，若入参对象中该字段为 `null`，则 SQL 中不会包含该字段，造成更新失败。此问题易引发数据不一致，尤其在编辑表单时用户清空某字段内容的场景下尤为突出。如何让空字段也能参与更新，成为使用该方法时的关键痛点。

Answer 1

1. 问题背景与现象描述

在使用 MyBatis-Plus 的 updateByExampleSelective 方法时，开发者常遇到一个典型问题：当传入的实体对象中某个字段值为 null 或空字符串（""）时，该字段不会被包含在生成的 SQL 更新语句中。这意味着数据库中的原有值不会被修改，即使业务逻辑明确要求将其置为 NULL 或清空。

例如，在用户编辑个人资料表单时，若用户将“备注”字段清空并提交，后端接收的对象中该字段为 null 或 ""，但由于 updateByExampleSelective 默认忽略这些值，导致数据库中仍保留旧值，造成数据不一致。

场景	期望行为	实际行为	后果
用户清空手机号	数据库字段设为 NULL	字段未更新	数据残留，影响后续验证
重置地址信息	地址字段为空字符串	原地址保留	历史数据污染
取消头像上传	avatar 字段设为 NULL	旧头像路径仍在	资源泄露风险

2. 深层原因分析

MyBatis-Plus 的 updateByExampleSelective 方法基于“选择性更新”原则设计，其核心逻辑是通过反射遍历实体对象的所有字段，仅对非 null 的字段生成对应的 SET 子句。这种机制虽然能避免误覆盖有效数据，但也带来了无法显式设置 NULL 值的局限。

从源码角度看，该方法依赖于 com.baomidou.mybatisplus.core.toolkit.ReflectionKit 中的字段提取逻辑，并结合 FieldStrategy 策略判断是否参与更新。默认情况下，字段策略为 NOT_NULL，即只处理非空字段。

// 示例：调用 updateByExampleSelective 实际生成的 SQL
UPDATE user 
SET name = '张三' 
WHERE id = 1;

// 即使传入对象中 email = null，也不会生成：SET email = NULL

此外，Java 对象中的基本类型（如 int、boolean）无法表示 null，进一步加剧了空值处理的复杂性。包装类型虽可解决此问题，但仍受限于字段更新策略。

3. 解决方案对比与实现路径

针对上述问题，业界存在多种解决方案，各具适用场景和优缺点。以下是主流方案的对比：

• 方案一：改用 updateByExample —— 强制更新所有字段，包括 null 值，但存在覆盖正常字段的风险。
• 方案二：自定义字段更新策略 —— 通过注解或全局配置调整字段处理规则。
• 方案三：手动构建 UpdateWrapper —— 使用条件构造器精确控制每个字段的更新行为。
• 方案四：AOP + 参数预处理 —— 在 DAO 层前拦截参数，注入特殊标记以绕过空值过滤。

graph TD A[调用 updateByExampleSelective] --> B{字段是否为 null?} B -- 是 --> C[跳过该字段] B -- 否 --> D[加入 SET 子句] C --> E[生成不完整的 SQL] D --> F[执行更新] E --> G[数据不一致风险]

4. 推荐实践：基于 FieldStrategy 的细粒度控制

MyBatis-Plus 提供了 @TableField 注解的 strategy 属性，可用于指定字段的更新策略。通过设置特定字段的策略为 FieldStrategy.IGNORED 或 FieldStrategy.ALWAYS，可实现对该字段空值的强制更新。

public class User {
    private Long id;
    
    @TableField(strategy = FieldStrategy.ALWAYS)
    private String email; // 允许 null 更新
    
    @TableField(strategy = FieldStrategy.IGNORED)
    private String remark; // 始终参与更新，即使为 null
}

此外，也可通过全局配置修改默认策略：

// application.yml
mybatis-plus:
  global-config:
    db-config:
      field-strategy: NOT_NULL # 可改为 ALWAYS 或 IGNORED

需要注意的是，全局设置为 ALWAYS 可能带来副作用，建议结合具体业务字段进行精细化配置。

5. 高级技巧：动态构建 UpdateWrapper 实现精准更新

对于需要高度灵活性的场景，推荐使用 UpdateWrapper 显式控制更新逻辑。这种方式不仅能处理 null 值，还可结合条件判断实现更复杂的更新策略。

LambdaUpdateWrapper<User> wrapper = new LambdaUpdateWrapper<>();
wrapper.eq(User::getId, userId);

if (StringUtils.isEmpty(input.getEmail())) {
    wrapper.set(User::getEmail, null); // 显式设置为 NULL
} else {
    wrapper.set(User::getEmail, input.getEmail());
}

if (input.getAge() != null) {
    wrapper.set(User::getAge, input.getAge());
}

userMapper.update(null, wrapper);

该方式的优势在于：

1. 完全掌控哪些字段参与更新；
2. 支持条件化更新逻辑；
3. 避免因对象映射导致的隐式忽略；
4. 便于日志追踪与调试；
5. 兼容复杂查询条件；
6. 可结合版本号实现乐观锁；
7. 支持批量更新优化；
8. 易于单元测试验证；
9. 降低对实体类注解的依赖；
10. 提升代码可读性与维护性。