解决 MyBatis-Plus 中 `update.setProcInsId(null)` 不生效的问题

解决 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()) 即可完成更新。

---

常见问题排查

1. 数据库字段是否允许为 NULL？

   • 检查数据库表结构，确保 proc_ins_id 字段允许存储 NULL 值。如果不允许，请修改表结构：

     ALTER TABLE it_virtual_resources MODIFY proc_ins_id VARCHAR(255) NULL;

2. 日志调试

   • 开启 MyBatis-Plus 的 SQL 日志输出，查看生成的 SQL 是否符合预期：

     mybatis-plus:
       configuration:
         log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

---

总结

• 推荐方法 ：优先使用 LambdaUpdateWrapper 显式设置字段为 NULL。
• 全局配置 ：如果需要频繁更新 NULL 值，可以配置全局更新策略。
• 实体类注解 ：针对特定字段，可以使用 @TableField(updateStrategy = FieldStrategy.IGNORED)。
• 手写 SQL：在特殊场景下，可以考虑手写 SQL 实现。

通过上述方法，你可以轻松解决 update.setProcInsId(null) 不生效的问题，确保数据库中的数据能够按照预期进行更新。

---

希望这篇文章对你有所帮助！欢迎关注我的博客，获取更多关于 Java 和 MyBatis-Plus 的实用技巧和经验分享。