MyBatis-Plus自动填充配置详解

MyBatis-Plus 的自动填充功能看似简单，实则暗藏多重陷阱：必须同时实现 `insertFill` 和 `updateFill`（或使用更精准的 `strictInsertFill`），字段需正确标注 `@TableField(fill = FieldFill.INSERT)` 等注解，且严禁 `static` 或 `transient` 修饰；时间类型务必严格匹配——`LocalDateTime` 字段只能填 `LocalDateTime.now()` 或经时区转换后的 `LocalDateTime`，绝不能混用 `Date` 或时间戳；常见“填充无效”往往源于注解遗漏、位置错误（必须在字段而非 getter 上）、Lombok 干扰或数据库默认值与 Java 层冲突。掌握这四重关键（类型一致、注解精准、修饰符合规、数据库协同），再配合日志调试，才能让创建/更新时间等字段真正可靠、静默、零失误地自动落库。

MetaObjectHandler 接口必须实现哪些方法才能生效

MyBatis-Plus 的自动填充靠 MetaObjectHandler 实现，但只重写部分方法是不够的。它有两个核心回调方法：insertFill 和 updateFill，分别对应插入和更新时的字段填充。如果你只实现了 insertFill，那创建时间字段在 insert 时能写入；但如果漏掉 strictInsertFill 或没配 @TableField(fill = FieldFill.INSERT)，字段压根不会进填充流程。

常见错误现象：日志里看不到填充日志，数据库字段仍是 NULL —— 很可能是因为实体类里没加 @TableField 注解，或者注解值写成了 FieldFill.INSERT_UPDATE（这个值只触发 updateFill）。

• @TableField(fill = FieldFill.INSERT) 是创建时间字段的正确配置
• 必须在 MetaObjectHandler 子类中重写 insertFill 方法，否则不调用
• 如果用了 MyBatis-Plus 3.4.0+，推荐用 strictInsertFill 替代旧版 insertFill，更明确指定字段名和类型

strictInsertFill 怎么写才不丢精度、不报错

创建时间通常用 LocalDateTime，但直接传 new Date() 或 System.currentTimeMillis() 容易出类型不匹配异常。MyBatis-Plus 在做反射赋值时会校验字段类型，strictInsertFill 要求你传入的值类型必须和实体字段一致。

典型翻车点：字段是 LocalDateTime createTime，却在 strictInsertFill 里填了 new Date()，结果抛 IllegalArgumentException: argument type mismatch。

• 填 LocalDateTime.now() 对应 LocalDateTime 字段
• 填 Instant.now() + .atZone(ZoneId.systemDefault()).toLocalDateTime() 更稳妥（避免时区歧义）
• 不要用 new Date() 或 System.currentTimeMillis() 直接塞进去
• 字段名字符串必须和实体类里完全一致，包括大小写，比如 "createTime" 不能写成 "create_time"

为什么 LocalDateTime.now() 填进去还是 null

不是代码没跑，而是 MyBatis-Plus 没识别到该字段需要填充。根本原因往往在实体类配置上：要么漏了 @TableField，要么写了但 fill 值不对，或者字段被 @TableLogic 或 @TableId 等注解干扰了处理顺序。

另一个隐蔽坑：字段加了 transient 关键字或 static 修饰符 —— MyBatis-Plus 会跳过这类字段，连反射都不到，自然不会触发填充。

• 检查字段是否被 static 或 transient 修饰
• 确认 @TableField(fill = FieldFill.INSERT) 写在字段上方，不是 getter 上方
• 如果用了 Lombok 的 @Data，确保没用 @Accessors(chain = true) 导致 setter 被覆盖（极少见，但有案例）
• 开启 MyBatis-Plus 日志：配置 mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl，看有没有 “field will be auto-filled” 类提示

自动填充和数据库默认值冲突怎么办

如果 MySQL 表结构里给 create_time 设了 DEFAULT CURRENT_TIMESTAMP，而 Java 层又用 MetaObjectHandler 填值，两者不冲突，但要注意顺序：MyBatis-Plus 先填充，SQL 才发出去，所以最终写入的是 Java 层的值。问题出在“想让数据库兜底，Java 层不填”，这时候就得关掉 Java 填充，而不是留空字段等数据库补。

性能影响很小，但兼容性要注意：PostgreSQL 不支持 CURRENT_TIMESTAMP 作为默认值自动触发填充（得靠触发器），所以跨库项目建议统一由 Java 层控制，别依赖数据库默认值。

• 要完全交由数据库，默认值设好后，Java 实体字段去掉 @TableField(fill = ...)
• 要 Java 控制，数据库字段默认值可以删掉，避免语义混淆
• 千万别两边都设，尤其当 Java 填的是固定时间（如测试用 LocalDateTime.of(2000,1,1,0,0)），会覆盖你预期的“当前时间”

自动填充看着简单，但字段类型、注解位置、时区、数据库配合这四点，少对一个就静默失效。调试时先盯日志输出，再查字段注解，最后看 SQL 绑定参数，别一上来就改 handler 逻辑。

到这里，我们也就讲完了《MyBatis-Plus自动填充配置详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！