今忱1. MyBatis-Plus 更新 null 字段问题解析
作为一名长期使用 MyBatis-Plus 的开发者，我经常遇到团队成员提出这样的疑问："为什么我设置了 null 值，数据库却没有更新？" 这确实是 MyBatis-Plus 中一个典型的设计特性，理解它的原理和解决方案对于日常开发至关重要。
MyBatis-Plus 默认不更新 null 字段的行为，本质上是一种安全机制。想象一下这样的场景：你从数据库查询出一个用户对象，修改了几个字段后想要更新，但有些字段你并没有特意处理。如果框架自动将这些未处理的字段更新为 null，可能会导致数据意外丢失。这种设计避免了"误伤"，让开发者必须显式地声明要更新为 null 的意图。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心机制解析
2.1 默认更新策略的工作原理
MyBatis-Plus 通过 @TableField 注解的 updateStrategy 属性控制字段的更新行为。默认值为 FieldStrategy.NOT_NULL，这意味着：
java复制// 默认等效于
@TableField(updateStrategy = FieldStrategy.NOT_NULL)
private String username;
在这种策略下，当你执行更新操作时，MyBatis-Plus 会检查每个字段的值：
- 如果字段值为 null → 不包含在 UPDATE 语句中
- 如果字段值不为 null → 包含在 UPDATE 语句中
这种机制通过动态生成 SQL 语句来实现。例如：
java复制User user = new User();
user.setId(1L);
user.setUsername(null);
user.setEmail("new@example.com");
userMapper.updateById(user);
实际生成的 SQL 会是：
sql复制UPDATE user SET email = 'new@example.com' WHERE id = 1
注意 username 字段没有被包含在更新语句中。
2.2 设计背后的考量
这种设计主要基于以下考虑因素：
- 数据安全性：防止因对象属性未正确初始化而意外清空字段
- 性能优化：只更新真正需要修改的字段，减少不必要的数据库操作
- 业务合理性：大多数业务场景下，null 值更新并非开发者本意
- 与 MyBatis 的兼容性：保持与原生 MyBatis 行为的一致性
3. 解决方案详解
3.1 方案一：字段级别策略覆盖（推荐）
最精确的控制方式是在特定字段上使用 @TableField 注解：
java复制@TableField(updateStrategy = FieldStrategy.IGNORED)
private String nickname;
这种方式的优势在于：
- 精确控制哪些字段允许更新为 null
- 不影响其他字段的默认行为
- 代码意图明确，易于维护
适合场景：
- 用户可选填的信息（如昵称、头像、个人简介）
- 需要显式清空的业务字段（如合同终止日期）
提示：FieldStrategy 还提供了其他选项：