快捷導(dǎo)航

MyBatis Plus 中 update_time 字段自動(dòng)填充失效的原因分析及解決方案(最新整理)

更新時(shí)間：2025年06月11日 15:17:56 作者：代碼怪獸大作戰(zhàn)

在使用MyBatis Plus時(shí),通常我們會(huì)在數(shù)據(jù)庫(kù)表中設(shè)置create_time和update_time兩個(gè)字段,借助 MyBatis Plus 的自動(dòng)填充功能來(lái)維護(hù)這些時(shí)間字段,下面通過(guò)本文介紹MyBatis Plus 中 update_time 字段自動(dòng)填充失效的原因分析及解決方案,感興趣的朋友一起看看吧

前言

在使用 MyBatis Plus 時(shí)，通常我們會(huì)在數(shù)據(jù)庫(kù)表中設(shè)置 create_time 和 update_time 兩個(gè)字段，借助 MyBatis Plus 的 自動(dòng)填充功能 來(lái)維護(hù)這些時(shí)間字段。

但是，有時(shí)候你可能會(huì)遇到 update_time 字段未自動(dòng)更新的情況，哪怕代碼中已經(jīng)配置了 MetaObjectHandler。本文將針對(duì)這一問(wèn)題，分析可能的原因，并提供詳細(xì)的解決方案。

一、問(wèn)題現(xiàn)象

假設(shè)我們有如下的 updateFill() 方法：

@Override
public void updateFill(MetaObject metaObject) {
	log.info("執(zhí)行更新填充...");
    this.strictInsertFill(metaObject, "updateTime", Timestamp.class, Timestamp.valueOf(LocalDateTime.now())); 
    this.strictInsertFill(metaObject, "updateBy", BigInteger.class, userId); 
}

但是執(zhí)行更新操作后：

數(shù)據(jù)庫(kù)中的 update_time 字段未更新
沒(méi)有報(bào)錯(cuò)，但 updateTime 依然是舊值
updateBy 可能也未更新

接下來(lái)我們來(lái)分析可能的原因。

二、原因分析

1. 使用了 strictInsertFill/strictUpdateFill 導(dǎo)致更新失效

原因：

strictInsertFill/strictUpdateFill 主要用于插入數(shù)據(jù)時(shí)的自動(dòng)填充。即使在 updateFill() 中使用它，也不會(huì)生效。

原理解釋：

strictInsertFill/strictUpdateFill 的作用是 如果字段已有值則不會(huì)覆蓋，而在更新場(chǎng)景中，一般實(shí)體對(duì)象中 update_time 已有值。

解決方案：

將 strictInsertFill/strictUpdateFill 替換為 setFieldValByName：

@Override
public void updateFill(MetaObject metaObject) {
    log.info("start update fill ....");
    this.setFieldValByName("updateTime", Timestamp.valueOf(LocalDateTime.now()), metaObject);
    this.setFieldValByName("updateBy", userId, metaObject);
}

原因分析補(bǔ)充：

strictInsertFill/strictUpdateFill → 插入/更新數(shù)據(jù)時(shí)填充，不適用于更新場(chǎng)景。
setFieldValByName → 更新數(shù)據(jù)時(shí)直接覆蓋字段值，即使原值存在。

2. 實(shí)體類注解配置錯(cuò)誤

原因：

實(shí)體類中的字段沒(méi)有正確標(biāo)注 @TableField(fill = FieldFill.INSERT_UPDATE)，導(dǎo)致自動(dòng)填充機(jī)制無(wú)法生效。

解決方案：

在實(shí)體類中正確設(shè)置注解：

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import lombok.Data;
import java.time.LocalDateTime;
@Data
public class User {
    private Long id;
    private String name;
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private BigInteger updateBy;
}

注意：

FieldFill.INSERT_UPDATE：用于插入和更新時(shí)自動(dòng)填充。
如果沒(méi)有加上這個(gè)注解，MyBatis Plus 不會(huì)執(zhí)行自動(dòng)填充邏輯。

3. MetaObjectHandler 未生效

原因：

MetaObjectHandler 需要被 Spring 管理。如果沒(méi)有加上 @Component 注解或沒(méi)有被掃描到，自動(dòng)填充方法不會(huì)執(zhí)行。

解決方案：

確保 FieldAutoFillHandler 類上有 @Component 注解：

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
@Slf4j
@Component
public class FieldAutoFillHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        log.info("執(zhí)行插入填充...");
        this.setFieldValByName("createTime", LocalDateTime.now(), metaObject);
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }
    @Override
    public void updateFill(MetaObject metaObject) {
        log.info("執(zhí)行更新填充...");
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }
}

注意：

如果項(xiàng)目中有多個(gè) MetaObjectHandler，需要確保不會(huì)有沖突。

4. 使用自定義 SQL 導(dǎo)致自動(dòng)填充失效

原因：

如果你在 Mapper.xml 中自定義了 update 語(yǔ)句，那么 MyBatis Plus 不會(huì)觸發(fā)自動(dòng)填充邏輯。

解決方案：

方法 1：在 XML 中手動(dòng)設(shè)置 update_time 字段：

<update id="updateUser" parameterType="com.example.entity.User">
    UPDATE user
    SET name = #{name},
        update_time = NOW(),
        update_by = #{updateBy}
    WHERE id = #{id}
</update>

方法 2：直接使用 BaseMapper 提供的 updateById() 等方法，MyBatis Plus 會(huì)自動(dòng)觸發(fā)填充：

User user = userMapper.selectById(1L);
user.setName("李四");
userMapper.updateById(user);

5. 字段類型不匹配

原因：

數(shù)據(jù)庫(kù)中 update_time 的數(shù)據(jù)類型與 Java 實(shí)體類的類型不匹配，導(dǎo)致填充失敗。

解決方案：

確保數(shù)據(jù)庫(kù)字段類型和實(shí)體類一致：

ALTER TABLE user
MODIFY update_time TIMESTAMP NULL DEFAULT NULL;

private LocalDateTime updateTime;

注意：

使用 LocalDateTime 處理時(shí)間字段是最佳實(shí)踐。
如果數(shù)據(jù)庫(kù)字段為 datetime 或 timestamp，不要使用 String 類型。

三、總結(jié)：常見(jiàn)原因與解決方法對(duì)照表

原因	現(xiàn)象	解決方法
使用了 `strictInsertFill`	`update_time` 未更新	使用 `setFieldValByName` 替代
實(shí)體類注解錯(cuò)誤	自動(dòng)填充無(wú)效	確保字段上加了 `@TableField(fill = FieldFill.INSERT_UPDATE)`
`MetaObjectHandler` 未生效	`updateFill()` 不執(zhí)行	確保加上 `@Component` 注解
使用自定義 SQL 覆蓋了默認(rèn)方法	填充邏輯未觸發(fā)	使用 `BaseMapper.updateById()` 或在 SQL 中手動(dòng)填充
數(shù)據(jù)類型不匹配	字段更新失敗	數(shù)據(jù)庫(kù)字段使用 `timestamp` 且實(shí)體類使用 `LocalDateTime`

四、推薦寫法

最終推薦的 updateFill() 寫法如下：

@Override
public void updateFill(MetaObject metaObject) {
    log.info("執(zhí)行更新填充...");
    this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    this.setFieldValByName("updateBy", userId, metaObject);
}

通過(guò)這種方式，確保 update_time 字段在更新時(shí)自動(dòng)更新，同時(shí)避免了不必要的填充失效問(wèn)題。

到此這篇關(guān)于MyBatis Plus 中 update_time 字段自動(dòng)填充失效的原因分析及解決方案(最新整理)的文章就介紹到這了,更多相關(guān)MyBatis Plus update_time 自動(dòng)填充失效內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: