解决 MyBatis-Plus 中 update.setProcInsId(null) 不生效的问题
在使用 MyBatis-Plus 进行数据库操作时，我们常常会遇到这样一个问题：尝试通过 update.setProcInsId(null) 将某个字段设置为 NULL，但实际操作中发现该字段并没有被更新。这主要是因为 MyBatis-Plus 默认会忽略值为 null 的字段更新，以避免不必要的数据库操作。本文将详细介绍几种解决这个问题的方法，并提供完整的代码示例。
背景介绍
假设我们有一个名为 ItVirtualResources 的实体类和对应的数据库表 it_virtual_resources，其中包含一个字段 proc_ins_id。现在的需求是根据业务对象（BO）更新 ItVirtualResources 实体，并将 proc_ins_id 字段设置为 NULL。然而，直接调用 update.setProcInsId(null) 并不能达到预期效果。
问题分析
MyBatis-Plus 在处理更新操作时，默认会忽略所有值为 null 的字段更新。这意味着即使你在实体对象中设置了某个字段为 null，该字段也不会被更新到数据库中。要解决这个问题，我们需要采取一些特殊措施。
解决方案
1. 使用 LambdaUpdateWrapper 显式设置字段为 NULL
这是最直接的解决方案。通过 LambdaUpdateWrapper，我们可以显式地指定哪些字段需要更新为 NULL。
// 创建 LambdaUpdateWrapper 对象
LambdaUpdateWrapper<ItVirtualResources> updateWrapper = new LambdaUpdateWrapper<>();
updateWrapper.eq(ItVirtualResources::getResourceId, resourceId);
// 显式设置字段为 NULL
updateWrapper.set(ItVirtualResources::getProcInsId, null)
.set(ItVirtualResources::getApplyStatus, VirtualResourcesApplyStatusEnum.TO_BE_CONFIRMED.getCode());
// 执行更新操作并返回更新结果
return virtualResourcesMapper.update(null, updateWrapper) > 0;
解释：
updateWrapper.set(ItVirtualResources::getProcInsId, null)：明确告诉 MyBatis-Plus 将proc_ins_id字段更新为NULL。virtualResourcesMapper.update(null, updateWrapper)：这里第一个参数为null，表示不依赖实体对象的字段值。
2. 配置全局策略以允许更新 NULL 值
如果你希望在整个项目中都允许更新 NULL 值，可以通过配置 MyBatis-Plus 的全局策略来实现。
在 application.yml 或 application.properties 中添加如下配置：
mybatis-plus:
global-config:
db-config:
update-strategy: ignored # 忽略字段值是否为 NULL，一律参与更新
然后修改你的代码：
// 创建一个新的虚拟资源对象用于更新
ItVirtualResources update = new ItVirtualResources();
buildItVirtualResources(bo, update);
update.setApplyStatus(VirtualResourcesApplyStatusEnum.TO_BE_CONFIRMED.getCode());
update.setProcInsId(null); // 设置为 NULL
// 创建 LambdaUpdateWrapper 对象
LambdaUpdateWrapper<ItVirtualResources> updateWrapper = new LambdaUpdateWrapper<>();
updateWrapper.eq(ItVirtualResources::getResourceId, resourceId);
// 执行更新操作并返回更新结果
return virtualResourcesMapper.update(update, updateWrapper) > 0;
3. 在实体类中配置字段更新策略
如果不想修改全局策略，可以在实体类中针对特定字段配置更新策略。
import com.baomidou.mybatisplus.annotation.FieldStrategy;
import com.baomidou.mybatisplus.annotation.TableField;
public class ItVirtualResources {
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String procInsId;
// 其他字段和 Getter/Setter 省略
}
这样，无论 procInsId 是否为 null，都会参与更新操作。
4. 手写 SQL 实现
在某些特殊场景下，你可能需要手写 SQL 来实现更复杂的更新逻辑。
@Mapper
public interface VirtualResourcesMapper extends BaseMapper<ItVirtualResources> {
@Update("UPDATE it_virtual_resources SET proc_ins_id = NULL, apply_status = #{applyStatus} WHERE resource_id = #{resourceId}")
int updateProcInsIdToNull(@Param("resourceId") Long resourceId, @Param("applyStatus") String applyStatus);
}
解释：
- 直接编写 SQL 语句，明确将
proc_ins_id设置为NULL。 - 调用
virtualResourcesMapper.updateProcInsIdToNull(resourceId, VirtualResourcesApplyStatusEnum.TO_BE_CONFIRMED.getCode())即可完成更新。
常见问题排查
数据库字段是否允许为
NULL？- 检查数据库表结构，确保
proc_ins_id字段允许存储NULL值。如果不允许，请修改表结构：ALTER TABLE it_virtual_resources MODIFY proc_ins_id VARCHAR(255) NULL;
- 检查数据库表结构，确保
日志调试
- 开启 MyBatis-Plus 的 SQL 日志输出，查看生成的 SQL 是否符合预期：
mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
- 开启 MyBatis-Plus 的 SQL 日志输出，查看生成的 SQL 是否符合预期：
总结
- 推荐方法：优先使用
LambdaUpdateWrapper显式设置字段为NULL。 - 全局配置：如果需要频繁更新
NULL值，可以配置全局更新策略。 - 实体类注解：针对特定字段，可以使用
@TableField(updateStrategy = FieldStrategy.IGNORED)。 - 手写 SQL：在特殊场景下，可以考虑手写 SQL 实现。
通过上述方法，你可以轻松解决 update.setProcInsId(null) 不生效的问题，确保数据库中的数据能够按照预期进行更新。
希望这篇文章对你有所帮助！欢迎关注我的博客，获取更多关于 Java 和 MyBatis-Plus 的实用技巧和经验分享。