@TableField(updateStrategy = FieldStrategy.IGNORED) 引起的数据丢失问题

背景

业务人员反映某某表数据莫名奇妙丢失了,要求系统排查。当时理解丢失是整条数据被删除了(文字表达精准的重要性/(ㄒoㄒ)/~~),于是排查所有delete相关代码,未发现异常。后经过反复沟通,业务表达的丢失是指某条记录的某两个属性值丢失,被置为null了(哭笑不得)。

于是继续排查,系统引入了mybatis-plus框架,数据表对应的实体其中有两个属性被加了 @TableField(updateStrategy = FieldStrategy.IGNORED) 引起注意。

java 复制代码
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String spclFieldName;

@TableField(updateStrategy = FieldStrategy.IGNORED)
private String valMpngFldNm;

FieldStrategy.IGNORED

通过智能助手得到的答案是:

@TableField(updateStrategy = FieldStrategy.IGNORED) 是 MyBatis-Plus 框架中的一个注解,用于指定某个字段在更新操作时的策略。

具体来说,@TableField 注解用于标识实体类中的字段与数据库表中的列之间的映射关系。而 updateStrategy 属性则用于定义在更新数据库记录时,该字段的更新策略。

FieldStrategy.IGNORED 是 updateStrategy 的一个值,它表示在更新操作中忽略该字段。这意味着,当你在使用 MyBatis-Plus 进行更新操作时,即使你为这个字段设置了新的值,MyBatis-Plus 也不会将这个字段的值更新到数据库中。

例如,假设你有一个 User 实体类,其中有一个 name 字段,并且你想在更新用户信息时忽略这个字段,那么你可以这样写:

java 复制代码
public class User {
   private Long id;
   
   @TableField(updateStrategy = FieldStrategy.IGNORED)
   private String name;
   
   // 其他字段和getter/setter方法
}

在这个例子中,即使你在更新 User 实体时设置了新的 name 值,这个值也不会被更新到数据库中。这可以用于保护某些重要字段,确保它们不会被意外修改。

而这里智能助手给的答案是错误的。当然这个单词确实也很容易让人误会,所以作者后面也抛弃了该注解。

通过mybatisplus官网查到这个注解意思:是忽略判断。而mybatisplus的默认全局判断策略是 not null判断,也就是说只有在值为非null的时候 update方法才会去修改对应的字段值。

以下为对应的源码:

Wrapper.java

java 复制代码
/**
 * 根据实体FieldStrategy属性来决定判断逻辑
 */
private boolean fieldStrategyMatch(TableInfo tableInfo, T entity, TableFieldInfo e) {
    switch (e.getWhereStrategy()) {
        case NOT_NULL:
            return Objects.nonNull(tableInfo.getPropertyValue(entity, e.getProperty()));
        case IGNORED:
            return true;
        case NOT_EMPTY:
            return StringUtils.checkValNotNull(tableInfo.getPropertyValue(entity, e.getProperty()));
        case NEVER:
            return false;
        default:
            return Objects.nonNull(tableInfo.getPropertyValue(entity, e.getProperty()));
    }
}

TableFieldInfo.java

java 复制代码
/**
 * 转换成 if 标签的脚本片段
 *
 * @param sqlScript     sql 脚本片段
 * @param property      字段名
 * @param fieldStrategy 验证策略
 * @return if 脚本片段
 */
private String convertIf(final String sqlScript, final String property, final FieldStrategy fieldStrategy) {
    if (fieldStrategy == FieldStrategy.NEVER) {
        return null;
    }
    if (isPrimitive || fieldStrategy == FieldStrategy.IGNORED) {
        return sqlScript;
    }
    if (fieldStrategy == FieldStrategy.NOT_EMPTY && isCharSequence) {
        return SqlScriptUtils.convertIf(sqlScript, String.format("%s != null and %s != ''", property, property),
            false);
    }
    return SqlScriptUtils.convertIf(sqlScript, String.format("%s != null", property), false);
}

发现,FieldStrategy.IGNORED就是忽略判断,

所以在 使用 update方法时,虽然那两个属性值为null,但最后生成的sql是

sql 复制代码
set spclFieldName=null,valMpngFldNm=null

导致这两个属性值丢失。

解决办法是去掉这两个注解,或者使用

java 复制代码
ChainWrappers.lambdaUpdateChain(this.getBaseMapper())
                    .set(IdxDefTblPo::getPerfDivdIntoInd, "1")
                    .in(IdxDefTblPo::getIdxId, yesList)
                    .update();

指定更新的字段和条件。

相关推荐
极客先躯31 分钟前
高级java每日一道面试题-2025年01月23日-数据库篇-主键与索引有什么区别 ?
java·数据库·java高级·高级面试题·选择合适的主键·谨慎创建索引·定期评估索引的有效性
码至终章34 分钟前
kafka常用目录文件解析
java·分布式·后端·kafka·mq
Mr.Demo.38 分钟前
[Spring] Nacos详解
java·后端·spring·微服务·springcloud
luoganttcc1 小时前
华为升腾算子开发(一) helloword
java·前端·华为
Dlwyz1 小时前
Maven私服-Nexus3安装与使用
java·maven
智_永无止境1 小时前
Springboot使用war启动的配置
java·spring boot·后端·war
九月十九2 小时前
AviatorScript用法
java·服务器·前端
翻晒时光2 小时前
深入解析Java集合框架:春招面试要点
java·开发语言·面试
sin22012 小时前
MyBatis-Plus的插件
java·mybatis
小丁爱养花2 小时前
Spring MVC:综合练习 - 深刻理解前后端交互过程
java·spring·mvc