SpringBlade 数据库字段的自动填充

今天上班时，发现项目代码中实体类中没有定义相关创建人，更新人等等字段，只是继承了两个父类实体就实现了自动填充，以下是记录：

为什么post表或者bp表新增的时候创建人id等字段自动出现？

a. SpringBlade框架的自动填充机制

主要原因在于 SpringBlade框架的自动填充机制。

实体类 BpTable 继承了 TenantEntity，而 TenantEntity 又继承了 BaseEntity（框架默认行为）。这些父类中已经包含了以下字段：

复制代码

public abstract class BaseEntity {
    private Long createUser;   // 对应 create_user
    private Long createDept;   // 对应 create_dept
    private LocalDateTime createTime;
    private Long updateUser;   // 对应 update_user
    private LocalDateTime updateTime;
    // 其他公共字段...
}

而SpringBlade 默认通过以下方式自动填充这些字段：

• 插入时 ：自动填充 create_user、create_dept、create_time

• 更新时 ：自动填充 update_user、update_time

b. 原理

这是通过框架的 元对象处理器（MetaObjectHandler） 实现的，例如：

复制代码

@Component
public class BladeMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        // 自动设置创建人、部门、时间
        this.strictInsertFill(metaObject, "createUser", Long.class, UserUtil.getUserId());
        this.strictInsertFill(metaObject, "createDept", Long.class, UserUtil.getDeptId());
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        // 自动设置更新人和时间
        this.strictUpdateFill(metaObject, "updateUser", Long.class, UserUtil.getUserId());
        this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }
}

c. 自动填充的启用与禁用

ⅰ. 保留自动填充（推荐）

如果这些字段需要自动记录操作人信息，无需任何修改，框架会持续自动维护这些字段。

ⅱ. 禁用自动填充

若需手动控制这些字段，需以下步骤：

方式一：从实体类中移除字段

复制代码

public class BpTable extends TenantEntity {
    // 移除继承的 TenantEntity，改为直接继承 BaseEntity 或完全自定义
    // 其他字段保持不变...
}

方式二：覆盖框架的自动填充逻辑

在实体类中显式忽略这些字段：

复制代码

@Data
@TableName("bp_table")
public class BpTable {
    @TableField(value = "create_user", fill = FieldFill.NONE)  // 禁止自动填充
    private Long createUser;

    @TableField(value = "create_dept", fill = FieldFill.NONE)
    private Long createDept;

    // 其他字段...
}

方式三：关闭全局自动填充（不推荐）

在配置文件中禁用 MyBatis-Plus 的自动填充：

复制代码

mybatis-plus:
  global-config:
    db-config:
      logic-not-delete-field: ""  # 关闭逻辑删除字段自动填充
      meta-object-handler: none   # 关闭所有自动填充（慎用）

ⅲ. 验证是否生效

插入数据后检查 SQL 日志，确认是否仍有自动填充行为：

复制代码

INSERT INTO bp_table (create_user, create_dept, update_user, ...) 
VALUES (?, ?, ?, ...)  # 如果值为NULL，说明已禁用成功