MetaObjectHandler 必须同时实现 insertFill 和 updateFill 方法，并在实体字段上正确配置 @TableField(fill = FieldFill.INSERT) 或 FieldFill.UPDATE，否则自动填充不生效；推荐使用 strictInsertFill 并确保传入值类型与字段一致（如 LocalDateTime.now() 对应 LocalDateTime 字段），且字段不能被 static 或 transient 修饰。
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 逻辑。
