告别手动set时间！MyBatis-Plus的MetaObjectHandler配置，90%的人可能都漏了这一步

告别手动set时间！MyBatis-Plus的MetaObjectHandler配置，90%的人可能都漏了这一步

在Spring Boot项目中，MyBatis-Plus的自动填充功能是提升开发效率的利器，但很多开发者在配置MetaObjectHandler时，往往会遇到自动填充不生效的问题。本文将带你深入排查这一常见问题，并提供一个完整的解决方案。

1. 自动填充功能的基本配置

首先，我们需要了解MyBatis-Plus自动填充的基本配置流程。以下是一个典型的配置步骤：

1. 添加依赖：确保项目中引入了MyBatis-Plus的starter依赖。
2. 实体类注解：在需要自动填充的字段上添加@TableField注解。
3. 实现MetaObjectHandler：创建一个类实现MetaObjectHandler接口，并添加@Component注解。

@Data public class User { @TableId(type = IdType.AUTO) private Long id; private String name; @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }

@Component public class MyMetaObjectHandler 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()); } }

2. 常见问题排查

当自动填充不生效时，可以按照以下步骤进行排查：

2.1 基础检查

• 确认@Component注解是否被正确扫描
• 检查字段类型是否匹配（如LocalDateTime与Date）
• 验证@TableField注解的fill属性是否正确

2.2 进阶排查

如果基础检查都通过，但自动填充仍然不生效，可能是以下原因：

1. 多数据源配置冲突：当项目中使用多数据源时，自定义的SqlSessionFactory可能会覆盖默认配置。
2. 特定版本问题：某些MyBatis-Plus版本可能存在已知的自动填充问题。
3. 全局配置缺失：在特定项目结构中，需要显式配置GlobalConfig。

3. 完整解决方案

对于大多数项目，特别是使用了多数据源或特定starter的项目，需要以下完整配置：

@Configuration public class MybatisPlusConfig { @Bean public GlobalConfig globalConfig() { GlobalConfig globalConfig = new GlobalConfig(); globalConfig.setMetaObjectHandler(new MyMetaObjectHandler()); return globalConfig; } @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 添加分页插件 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }

对于更复杂的多数据源场景，需要为每个数据源单独配置：

@Bean public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { MybatisSqlSessionFactoryBean factoryBean = new MybatisSqlSessionFactoryBean(); factoryBean.setDataSource(dataSource); GlobalConfig globalConfig = new GlobalConfig(); globalConfig.setMetaObjectHandler(new MyMetaObjectHandler()); factoryBean.setGlobalConfig(globalConfig); return factoryBean.getObject(); }

4. 最佳实践与性能优化

为了确保自动填充功能的高效运行，建议遵循以下最佳实践：

1. 使用strict模式：在MetaObjectHandler实现中使用strictInsertFill和strictUpdateFill方法，可以避免字段类型不匹配的问题。
2. 避免频繁创建对象：对于常用的填充值（如当前时间），可以缓存而不是每次都创建新对象。
3. 日志记录：在MetaObjectHandler中添加适当的日志，方便调试和问题排查。

@Component @Slf4j public class OptimizedMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { log.debug("开始执行插入自动填充"); LocalDateTime now = LocalDateTime.now(); this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, now); this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, now); } @Override public void updateFill(MetaObject metaObject) { log.debug("开始执行更新自动填充"); this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }

在实际项目中，我曾遇到一个典型问题：在多模块项目中，由于包扫描范围设置不当，导致MetaObjectHandler未被正确加载。通过显式配置GlobalConfig并检查包扫描范围，最终解决了这个问题。