使用Mybatis-plus更新null字段的问题分析及解决过程

一、起因

最近在项目中遇到一个需求：需要将Oracle数据库里某个特定字段的值更新为Null。这听起来是个简单的操作，但在使用MyBatis-Plus时，却遇到了意料之外的阻碍。

遇到问题，第一反应当然是去搜索解决方案。网上相关的帖子确实不少，给出的方法也大同小异。但逐一尝试下来，发现要么讲得不够透彻，要么就是对我的具体场景不适用——说白了，都没能真正解决问题。

二、常见的解决方案，为何在这里失灵？

首先排除“全局配置”方案。因为只有这个表的这个字段需要更新为Null，其他字段仍需保持非空检查，全局改动显然不合适。

那么，目光自然就转向了第二种方案：在需要更新为Null的字段上添加注解 @TableField(strategy = FieldStrategy.IGNORED)。这个思路是对的，因为MyBatis-Plus默认会对字段进行非空判断，而IGNORED策略正是用来忽略这个判断的。看看源码就一目了然：

//字段策略枚举类
public enum FieldStrategy {
    IGNORED(0, "忽略判断"),
    NOT_NULL(1, "非 NULL 判断"),
    NOT_EMPTY(2, "非空判断");
    //省略部分代码
}

所以，正确的配置应该是这样：

@TableField(value = "BIRTHDAY", strategy = FieldStrategy.IGNORED)
private Date birthday;

这里需要提一句，所谓的全局配置，本质上也是修改这个枚举的默认值。但为了一个字段而改动全局规则，这显然不是个好主意。

然而，问题就出在这里。按照网上绝大多数教程，配置到这一步就应该大功告成了。但实际情况是，配置完后运行，程序依然报错。错误提示指向了ja vaType的类型是other。去查了一下源码，果然，这个属性的默认值就是other。

三、突破瓶颈：找到真正的解决之道

配置了FieldStrategy.IGNORED依然报错，说明问题更深一层。关键在于如何正确配置ja vaType。

针对这个问题，网上能找到的另一种方案是：放弃MyBatis-Plus的便捷性，回头去写原始的XML SQL语句，在SQL中通过#{property, jdbcType=XXX}来指定类型。就像这样：

　　insert into cost values(
    　　cost_seq.nextval,
　　    #{name,jdbcType=VARCHAR},
　　    #{base_duration,jdbcType=INTEGER},
　　    #{base_cost,jdbcType=DOUBLE}
　　)

这种方法理论上可行，但我没有尝试。原因很简单：我们选择MyBatis-Plus，不就是为了避免编写繁琐的SQL吗？如果为了解决Null更新问题而重写SQL，那岂不是背离了使用框架的初衷？更何况，直接写SQL根本就不会触发之前的那个错误。

那么，有没有一种办法，既能享受MyBatis-Plus的便利，又能完美解决Null更新问题呢？答案是肯定的。

其实，MyBatis-Plus的@TableField注解支持一个强大的el属性（Expression Language）。通过它，我们可以直接指定jdbcType。源码的注释里已经给出了提示：

    /**
     * 

     * 当该Field为类对象时, 可使用#{对象.属性}来映射到数据表.
     * 
     * 

     * 支持：@TableField(el = "role, jdbcType=BIGINT)

     * 支持：@TableField(el = "role, typeHandler=com.baomidou.springcloud.typehandler.PhoneTypeHandler")
     * 
     */
    String el() default "";

看到这里，可能还是有点抽象。别急，直接看最终配置。

最终配置方式一：注解指定

在字段注解中，同时指定strategy和el属性：

    /** 检验结果单位（码值：lab_result_unit）*/
	@TableField(value="lab_result_unit", strategy = FieldStrategy.IGNORED, el = "labResultUnit,jdbcType=DECIMAL")
	private Integer labResultUnit;

这样配置后，MyBatis-Plus在生成SQL时，就会忽略该字段的非空判断，并为其赋予正确的DECIMAL jdbcType，从而允许Null值被顺利更新到数据库。

最终配置方式二：全局配置（备选）

如果你确实有多个字段需要类似处理，或者偏好全局配置，也可以在application.yml中设置：

mybatis-plus:
  configuration:
    jdbc-type-for-null: 'null' #注意：单引号是必须的

这个配置会让MyBatis-Plus对所有Null参数都使用JDBC的NULL类型，也是一种解决方案。但请注意，这会影响全局，需根据项目实际情况权衡。

回顾整个过程，网上很多文章提供的解决方案在其特定环境下可能有效，但软件开发中，“一招鲜吃遍天”的情况很少。更多时候，需要像这样层层剖析，结合框架源码和自身业务场景，才能找到那条真正适合自己的路径。

总结

解决MyBatis-Plus更新Null字段的问题，核心在于两点：一是通过FieldStrategy.IGNORED绕过字段的非空更新策略；二是在某些数据库驱动（如Oracle）下，需要通过el属性或全局配置明确指定Null值的jdbcType，以避免类型映射错误。希望这个具体的排查和解决过程，能为你遇到类似问题时提供一个清晰的参考。