MyBatis Plus 字段自动填充：生产级实现方案与原理分析

背景与问题

在企业级应用开发中，数据库表设计通常包含审计字段，如 create_time（创建时间）、update_time（更新时间）。传统开发模式下，开发者需要在 Service 层手动调用 Setter 方法进行赋值。这种方式存在明显的缺陷：

代码冗余 ：Setter 代码充斥在业务逻辑中。
维护隐患：遗漏赋值导致数据不完整。
高耦合：业务逻辑与基础审计数据强耦合。

MyBatis Plus 提供了 MetaObjectHandler 接口，基于 AOP 思想拦截 SQL 执行过程，实现字段自动填充。本文介绍该功能的生产级实现及关键细节。

实现 MyBatis Plus 的自动填充（Auto-fill）功能，主要分为三步：改实体类注解 -> 写处理器策略 -> 删业务层代码。

核心实现步骤

1. 实体类配置 (Entity Layer)

通过 @TableField 注解的 fill 属性指定填充策略。

Java 复制代码

@Data
@TableName("tb_user")
public class User implements Serializable {

    // ... 忽略主键及其他业务字段 ...

    /**
     * 创建时间
     * 策略：INSERT (仅在插入时填充)
     */
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;

    /**
     * 更新时间
     * 策略：INSERT_UPDATE (在插入和更新时均填充)
     * 注意：必须包含 INSERT，否则新插入数据的 update_time 为 null
     */
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

2. 元数据处理器实现 (Configuration Layer)

实现 MetaObjectHandler 接口。注意：生产环境严禁在此类高频回调中打印 INFO 日志，以避免 I/O 性能瓶颈。

Java 复制代码

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        // 使用通用反射方法 setFieldValByName，兼容性优于 strictInsertFill
        this.setFieldValByName("createTime", LocalDateTime.now(), metaObject);
        // 关键点：插入时也必须初始化 updateTime
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        // 更新操作仅需刷新 updateTime
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
    }
}

3. 业务层应用 (Service Layer)

配置完成后，Service 层无需再关注审计字段，代码聚焦于核心业务。

Java 复制代码

// UserServiceImpl.java
private User createUser(String phone) {
    User user = new User();
    user.setPhone(phone);
    
    // 核心变化：无需手动调用 setCreateTime 和 setUpdateTime
    // 框架将在执行 save/update 方法时自动处理
    save(user); 
    return user;
}

技术细节与最佳实践

1. 填充策略的陷阱

对于 update_time 字段，常见的错误配置是 FieldFill.UPDATE。

问题：MyBatis Plus 的默认行为是，配置为 FieldFill.UPDATE 的字段在 INSERT 语句执行时会被跳过，这会导致新数据的 update_time 为 NULL。
规范：必须配置为 FieldFill.INSERT_UPDATE，确保数据生命周期初始阶段字段值的完整性。

2. 方法选择与反射机制

推荐使用 this.setFieldValByName() 而非 strictInsertFill()。

原理：setFieldValByName() 内部直接基于反射操作对象属性，对 null 值和类型的容错性更强，能适应更多复杂的对象继承结构。

3. 性能考量

MetaObjectHandler 处于数据库写入的关键路径 （Hot Path）上。

规范：严禁在 insertFill()/updateFill() 中执行耗时操作（如 RPC 调用、复杂计算）或打印非必要的日志。任何此处的阻塞都会直接线性增加数据库事务的持有时间。

总结

通过 MyBatis Plus 的自动填充机制，实现了业务逻辑与审计逻辑的解耦。在生产级落地时，需重点关注数据一致性 （策略选择）和运行时性能（避免无谓 I/O），从而构建健壮的持久层架构。