MyBatis-Plus自动填充功能深度解析与实践指南

一、自动填充机制的核心原理

MyBatis-Plus的自动填充功能是基于实体类字段注解和元对象处理器（MetaObjectHandler）的协作实现的。其核心工作流程可分为三个关键阶段：

1. 注解识别阶段：系统通过扫描实体类字段上的@TableField(fill = FieldFill.xxx)注解，识别需要自动处理的字段及其填充策略（INSERT/UPDATE/INSERT_UPDATE）。

2. SQL拦截阶段：在执行INSERT或UPDATE操作时，MyBatis-Plus的拦截器会检查操作涉及的字段是否需要自动填充。

3. 处理器执行阶段：根据字段注解配置，调用对应的insertFill()或updateFill()方法，通过反射机制完成字段值的注入。

二、填充策略的精细控制

在实际开发中，我们经常需要根据不同业务场景配置不同的填充策略：

1. 基础填充策略

// 仅在插入时填充
@TableField(fill = FieldFill.INSERT)
private String createUser;

// 仅在更新时填充
@TableField(fill = FieldFill.UPDATE)
private LocalDateTime updateTime;

// 插入和更新时都填充
@TableField(fill = FieldFill.INSERT_UPDATE)
private String operator;

2. 高级填充技巧

对于需要强制更新的场景（无论字段是否有值），可以采用以下方案：

public class ForceUpdateMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void updateFill(MetaObject metaObject) {
        // 直接设置值，不检查字段是否为空
        this.setFieldValByName("updateTime", LocalDateTime.now(), metaObject);
        this.setFieldValByName("updateBy", getCurrentUserId(), metaObject);
    }
}

三、常见问题解决方案

1. 更新时填充失效问题

当使用strictUpdateFill方法时，如果字段已有值则不会覆盖。这是设计上的安全机制，防止意外覆盖业务数据。如需强制更新，应改用setFieldValByName方法。

2. 多租户环境下的用户信息填充

在需要获取当前用户信息的场景下，建议采用线程安全的方式：

private Long getCurrentUserId() {
    try {
        return SecurityContextHolder.getUserId();
    } catch (Exception e) {
        return -1L; // 返回系统用户或匿名用户标识
    }
}

四、最佳实践建议

1. 类型安全：使用strictXxxFill方法时，务必确保字段类型与处理器中声明的类型完全一致。

2. 异常处理：在自动填充处理器中做好异常捕获，避免因填充失败导致整个业务流程中断。

3. 审计字段设计：建议将创建时间、创建人、更新时间、更新人等字段设计为基本字段，采用INSERT_UPDATE策略。

4. 性能考量：对于高频更新的业务表，考虑将自动填充字段设置为索引，但需注意索引维护成本。

五、扩展应用场景

1. 数据版本控制：结合@Version注解实现乐观锁，在更新时自动填充版本号。

2. 逻辑删除标记：配合@TableLogic注解，实现删除操作的自动标记填充。

3. 多租户隔离：通过自动填充租户ID，实现数据自动隔离。

通过深入理解MyBatis-Plus的自动填充机制，开发者可以大幅减少样板代码，提高数据一致性和开发效率。在实际项目中，应根据具体业务需求选择合适的填充策略，并注意处理好边界情况和异常场景。