从入门到精通：MyBatis-Plus 自动填充时间字段的 3 种方式，第 2 种最常用

第一章：MyBatis-Plus 自动填充机制概述

MyBatis-Plus 提供了强大的自动填充功能，用于在数据插入或更新时自动处理特定字段的赋值操作，例如创建时间、更新时间、操作人等公共字段。该机制通过拦截 SQL 执行过程，在执行 INSERT 或 UPDATE 操作前动态填充指定字段，避免在业务代码中重复编写赋值逻辑，提升开发效率并保证数据一致性。

核心实现原理

自动填充功能依赖于 MyBatis-Plus 的元对象处理器（MetaObjectHandler）接口。开发者需实现该接口，并重写对应方法以定义字段填充规则。框架在执行 SQL 前会根据操作类型调用相应方法，完成字段注入。

启用自动填充步骤

1. 定义实体类并使用 @TableField 注解标记需要自动填充的字段
2. 创建配置类实现 MetaObjectHandler 接口
3. 在 Spring Boot 启动类或配置类上确保扫描到处理器

例如，以下代码展示了如何为 createTime 和 updateTime 字段设置自动填充：

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        // 插入时填充 createTime 和 updateTime
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        // 更新时仅填充 updateTime
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

注解属性	作用	示例值
fill	指定填充策略	FILL_INSERT、FILL_UPDATE、FILL_INSERT_UPDATE
value	字段名	createTime

graph TD A[执行 Insert/Update] --> B{MetaObjectHandler 拦截} B --> C[调用 insertFill 或 updateFill] C --> D[反射设置字段值] D --> E[继续执行 SQL]

第二章：基于注解的自动填充实现方式

2.1 理解 @TableField(fill = FieldFill) 注解作用

自动填充字段机制

在 MyBatis-Plus 中，@TableField(fill = FieldFill) 用于标识实体类字段在执行插入或更新操作时的自动填充策略。该注解常用于创建时间、更新时间、操作人等公共字段的自动化管理。

• FieldFill.INSERT：仅在插入时填充
• FieldFill.UPDATE：仅在更新时填充
• FieldFill.INSERT_UPDATE：插入和更新均填充

代码示例与说明

@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;

@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;

上述代码中，createTime 仅在新增记录时由框架自动赋值，updateTime 则在新增和修改时均会被填充。需配合实现 MetaObjectHandler 接口完成具体填充逻辑，从而实现数据同步一致性。

2.2 定义实体类中的时间字段与填充策略

在持久层设计中，合理定义时间字段及其自动填充机制可显著提升数据一致性。通常需包含创建时间与更新时间两个核心字段。

常用时间字段设计

• createTime：记录数据首次插入时间，仅初始化一次
• updateTime：每次数据变更时自动刷新

/**
 * 使用 MyBatis Plus 注解实现自动填充
 */
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createTime;

@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updateTime;

上述代码通过 @TableField 注解声明填充策略：FieldFill.INSERT 表示仅插入时填充，FieldFill.INSERT_UPDATE 则在插入和更新操作中均触发填充逻辑。

填充处理器实现

需配合元对象处理器完成自动赋值：

@Component
public class TimeMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

2.3 编写 MetaObjectHandler 实现基础填充逻辑

自动填充字段的职责边界

MyBatis-Plus 的 MetaObjectHandler 专用于拦截实体对象的插入/更新操作，动态注入创建人、时间等公共字段，避免在业务层重复赋值。

标准实现代码

public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); // 起始时间
        this.strictInsertFill(metaObject, "createdBy", String.class, "system"); // 默认创建人
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

strictInsertFill 确保仅当字段为 null 或空时才填充；参数依次为元对象、字段名、类型、默认值。该机制与 @TableField(fill = FieldFill.INSERT) 注解协同生效。

字段填充策略对照表

填充时机	支持字段	是否覆盖已有值
INSERT	createTime, createdBy	否（strict 模式）
UPDATE	updateTime	是（每次更新均刷新）

2.4 测试插入操作时创建时间的自动填充效果

验证自动填充行为

执行插入语句后，数据库应忽略显式传入的 created_at 值，强制使用服务端当前时间戳。

INSERT INTO users (name, email, created_at) 
VALUES ('Alice', 'alice@example.com', '2020-01-01 00:00:00');

该 SQL 显式指定过期时间，但若字段定义为 created_at DATETIME DEFAULT CURRENT_TIMESTAMP，MySQL 将自动覆盖传入值。

预期结果对比

字段	插入前传入值	实际入库值
created_at	2020-01-01 00:00:00	2024-06-15 14:22:33（实时时间）

关键约束条件

• 字段必须声明 DEFAULT CURRENT_TIMESTAMP 且无 NULL 允许
• 插入语句中不可使用 DEFAULT 关键字显式覆盖

2.5 验证更新操作时更新时间的自动填充行为

在持久层框架中，实体更新时的字段自动填充机制至关重要。以 GORM 为例，通过定义 `UpdatedTime` 字段并结合钩子函数，可实现更新时间的自动写入。

type User struct {
    ID          uint      `gorm:"primarykey"`
    Name        string
    UpdatedTime time.Time `gorm:"autoUpdateTime"` // 自动设置为当前时间
}

上述代码中，`autoUpdateTime` 标签指示 GORM 在每次执行 `Save` 或 `Updates` 操作时自动将 `UpdatedTime` 字段更新为当前时间戳，无需手动赋值。

触发条件与行为验证

该机制仅在非零值更新时生效。可通过单元测试验证其一致性：

• 执行首次创建，确认 CreatedTime 与 UpdatedTime 相同
• 执行更新操作后，检查 UpdatedTime 是否被刷新
• 确保未显式修改该字段的前提下仍发生变更

第三章：使用枚举策略优化填充逻辑

3.1 定义自定义填充枚举类型提升可读性

在开发过程中，使用魔法值（magic values）会使代码难以维护。通过定义自定义枚举类型，可以显著提升代码的可读性和可维护性。

Go语言中的枚举实现

Go 语言虽无原生枚举，但可通过自定义类型和常量模拟：

type Status int

const (
    Pending Status = iota
    Approved
    Rejected
)

func (s Status) String() string {
    return [...]string{"Pending", "Approved", "Rejected"}[s]
}

上述代码定义了 Status 类型，iota 自动生成递增值，String() 方法提供语义化输出，增强日志与调试体验。

优势分析

• 提高代码可读性：状态名代替数字
• 避免非法值传入：类型系统约束
• 便于扩展：支持方法绑定与格式化输出

3.2 在实体中应用枚举策略绑定填充字段

在现代ORM框架中，将枚举类型与实体字段绑定可显著提升数据一致性与可读性。通过定义类型安全的枚举，可避免魔数（Magic Number）直接暴露于业务逻辑中。

枚举策略实现示例

public enum OrderStatus {
    PENDING(1, "待处理"),
    SHIPPED(2, "已发货"),
    COMPLETED(3, "已完成");

    private final int code;
    private final String label;

    OrderStatus(int code, String label) {
        this.code = code;
        this.label = label;
    }

    public static OrderStatus fromCode(int code) {
        return Arrays.stream(values())
                     .filter(status -> status.code == code)
                     .findFirst()
                     .orElseThrow(() -> new IllegalArgumentException("Invalid code: " + code));
    }
}

上述代码定义了订单状态枚举，每个枚举值关联一个数据库存储码（code）和展示标签。fromCode 方法支持从数据库值反序列化为枚举实例。

实体字段绑定

使用 JPA 时可通过 @Enumerated(EnumType.STRING) 或自定义类型映射实现持久化。推荐使用整型存储以节省空间，并配合 Hibernate 的 @TypeDef 实现自动转换。

• 提升字段语义清晰度
• 减少数据不一致风险
• 支持编译期类型检查

3.3 结合 MetaObjectHandler 完成枚举驱动填充

在 MyBatis-Plus 中，`MetaObjectHandler` 提供了自动填充功能，结合枚举可实现字段的智能化赋值。通过定义填充规则，能够在插入或更新时自动处理创建人、时间等公共字段。

枚举驱动策略设计

使用枚举统一管理可填充字段及其逻辑，提升可维护性：

public enum FillField {
    CREATE_TIME(FieldFill.INSERT, "createTime"),
    UPDATE_TIME(FieldFill.INSERT_UPDATE, "updateTime");

    private final FieldFill strategy;
    private final String columnName;

    FillField(FieldFill strategy, String columnName) {
        this.strategy = strategy;
        this.columnName = columnName;
    }
}

上述枚举明确标注各字段的填充时机（如仅插入或全场景），便于后续统一解析。

自动填充实现

实现 `MetaObjectHandler` 接口并注入 Spring 容器：

@Component
public class AutoFillHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        for (FillField field : FillField.values()) {
            if (field.getStrategy() == FieldFill.INSERT || 
                field.getStrategy() == FieldFill.INSERT_UPDATE) {
                strictInsertFill(metaObject, field.getColumnName(), 
                                LocalDateTime.class, LocalDateTime.now());
            }
        }
    }
}

该处理器遍历枚举定义的字段，在插入时自动填充时间类型字段，避免手动设置，保障数据一致性。

第四章：全局配置与最佳实践方案

4.1 配置 GlobalConfig 启用自动填充功能

在 MyBatis-Plus 中，`GlobalConfig` 是核心配置类之一，用于全局控制框架行为。启用自动填充功能需通过该配置注入元数据处理逻辑。

配置步骤

• 创建 `MetaObjectHandler` 实现类并重写填充方法
• 在 Spring Boot 配置类中注册 `GlobalConfig` Bean

@Bean
public MybatisPlusConfig globalConfig() {
    return new MybatisPlusConfig()
        .setMetaObjectHandler(new MyMetaObjectHandler());
}

上述代码将自定义的元对象处理器注册到全局配置中。`MyMetaObjectHandler` 需实现 `insertFill` 和 `updateFill` 方法，分别处理插入和更新时的字段填充逻辑。例如可自动设置 `create_time`、`update_time` 等公共字段，提升数据一致性与开发效率。

4.2 统一处理 createTime 和 updateTime 的填充规则

在持久层设计中，统一管理 `createTime` 与 `updateTime` 能有效避免业务代码侵入。通过框架级自动填充机制，可确保时间字段的一致性与准确性。

基于拦截器的自动填充策略

使用 MyBatis Plus 提供的元对象处理器，可在插入和更新时自动注入时间字段：

@Component
public class TimeMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

上述代码中，`strictInsertFill` 确保插入时填充创建与更新时间，`strictUpdateFill` 在更新操作时仅更新 `updateTime`，避免误改 `createTime`。

字段填充逻辑对比

操作类型	createTime	updateTime
INSERT	自动填充当前时间	自动填充当前时间
UPDATE	保持原值不变	更新为当前时间

4.3 多环境下的填充逻辑兼容性设计

在构建跨环境应用时，填充逻辑需适配不同配置与数据源。为确保开发、测试与生产环境的一致性，应采用动态配置驱动的填充策略。

环境感知的填充处理器

通过环境标识动态加载填充规则：

@Component
public class EnvironmentAwareFiller {
    @Value("${app.env:dev}")
    private String environment;

    public void fill(DataModel model) {
        switch (environment) {
            case "prod":
                model.setApiKey(generateProdKey());
                break;
            default:
                model.setApiKey("DEV-MOCK-KEY"); // 安全隔离
        }
    }
}

上述代码根据 `app.env` 配置决定密钥生成逻辑，生产环境使用真实密钥，其余环境使用模拟值，避免敏感泄露。

多环境字段映射对照表

字段名	开发环境值	生产环境值
timeout	1000ms	5000ms
retry.count	1	3

4.4 性能考量与线程安全注意事项

在高并发场景下，缓存的性能表现与线程安全性至关重要。不当的设计可能导致数据竞争、内存泄漏或性能瓶颈。

线程安全机制

使用读写锁可提升并发读取效率。以下为 Go 语言示例：

var mu sync.RWMutex
var cache = make(map[string]string)

func Get(key string) string {
    mu.RLock()
    defer mu.RUnlock()
    return cache[key]
}

该实现允许多个读操作并发执行，写操作则独占锁，有效降低读写冲突。

性能优化建议

• 避免在热点路径中执行复杂计算
• 采用分段锁减少锁竞争
• 定期评估缓存命中率以调整策略

第五章：总结与扩展思考

性能优化的实际路径

在高并发系统中，数据库连接池的调优至关重要。以 Go 语言为例，合理设置最大连接数和空闲连接数可显著降低响应延迟：

// 设置PostgreSQL连接池参数
db.SetMaxOpenConns(50)
db.SetMaxIdleConns(10)
db.SetConnMaxLifetime(time.Hour)

微服务架构下的容错设计

采用熔断机制可在依赖服务异常时防止雪崩。Hystrix 或 Resilience4j 提供了成熟的实现方案，以下为典型配置策略：

• 请求超时阈值设为 800ms
• 10秒内错误率超过50%触发熔断
• 熔断持续时间为30秒，期间快速失败
• 半开状态后逐步恢复流量

可观测性体系建设对比

现代系统需结合日志、指标与链路追踪。下表展示了主流工具组合的应用场景：

需求维度	推荐工具	适用场景
日志聚合	ELK Stack	业务审计、错误定位
实时监控	Prometheus + Grafana	系统负载、QPS趋势分析
分布式追踪	Jaeger + OpenTelemetry	跨服务延迟诊断

安全加固的落地实践

建议部署WAF（Web应用防火墙）并启用以下规则： - SQL注入检测（正则匹配 union select 等关键字） - XSS过滤（拦截 script 标签及 javascript: 协议） - 频率限制（单IP每分钟最多100次请求）