MyBatis-Plus中时间类型自动填充的注意事项

在SpringBoot项目中使用MyBatis-Plus进行开发时，时间字段的自动填充是一个常见的需求。本文将通过一个典型问题案例，深入分析时间类型自动填充的实现原理和最佳实践。

问题现象

开发者在SpringBoot 3.3.3项目中使用Kotlin语言开发时，配置了MyBatis-Plus的自动填充功能，但实际运行时发现：

1. 数据库表定义了create_at和update_at字段，均为datetime类型
2. 配置了MetaObjectHandler实现类进行自动填充
3. 实体类中使用@TableField注解标记了自动填充策略
4. 实际插入数据时却报错"Column 'create_at' cannot be null"

问题根源分析

经过排查发现，问题的根本原因在于实体类中时间字段的类型定义与自动填充处理器中的类型不匹配：

1. 实体类中使用了Date类型
2. 自动填充处理器中尝试填充的是LocalDateTime类型
3. 这种类型不匹配导致自动填充逻辑未能正确执行

解决方案

正确的做法是保持类型一致性：

data class Video(
    var id: Long? = null,
    var title: String? = null,

    @TableField(fill = FieldFill.INSERT)
    var create_at: LocalDateTime? = null,

    @JsonIgnore
    @TableField(fill = FieldFill.UPDATE)
    var update_at: LocalDateTime? = null,
)

深入理解自动填充机制

MyBatis-Plus的自动填充功能是通过以下组件协同工作实现的：

1. @TableField注解：标记字段的自动填充策略（INSERT/UPDATE/INSERT_UPDATE）
2. MetaObjectHandler接口：提供insertFill和updateFill方法实现填充逻辑
3. 类型严格匹配：自动填充时会对字段类型进行严格校验

最佳实践建议

1. 类型一致性原则：确保实体类字段类型与填充处理器中的类型完全一致
2. 推荐使用LocalDateTime：在新项目中建议统一使用Java 8的日期时间API
3. 日志调试：在MetaObjectHandler中添加日志，方便排查问题
4. 数据库设计：考虑设置合理的默认值，作为自动填充的备份方案

总结

时间字段的自动填充是MyBatis-Plus提供的一个非常实用的功能，但在使用时需要注意类型匹配问题。通过本文的分析，开发者可以更好地理解自动填充机制的工作原理，避免在实际开发中遇到类似问题。记住类型一致性是关键，同时合理利用日志和数据库默认值可以提高系统的健壮性。