Java映射MySQL新版日期类型需驱动、配置、API协同：用8.0+驱动，URL配serverTimezone=GMT&useLegacyDatetimeCode=false，DATETIME字段直连LocalDateTime，无需工具类或中间转换。
Java 中正确映射 MySQL 新版日期类型（如 DATETIME 对应 LocalDateTime）的关键，不是写一堆转换工具类，而是确保驱动、配置、API 三者协同工作。只要版本对、参数设对、用法对，JDBC 就能原生支持，无需手动 parse/format。
驱动版本必须是 MySQL Connector/J 8.0+
旧版驱动（如 5.1.x）根本不识别 java.time 类型，调用 setObject(1, localDateTime) 会直接抛 SQLException 或静默转成 Timestamp，导致时区错乱或精度丢失。
- 检查 Maven 依赖是否为
mysql:mysql-connector-java:8.0.33或更高（2026 年推荐用 8.0.33+ 或 8.3.x） - 避免混用：项目里不能同时存在
mysql-connector-java:5.1.49和新版驱动（类加载冲突） - Spring Boot 3.x 默认已拉取 8.0+ 驱动，但若手动降级过需确认
连接 URL 必须显式配置时区和 Legacy 模式
MySQL 默认使用服务器本地时区，而 LocalDateTime 是无时区的。不加约束会导致插入时间比预期快/慢几小时，尤其在跨地域部署时。
Mysql Skill 1.0.0 (3)
下载
MySQL 数据库管理技能，能够通过自然语言查询和管理数据库，支持 SELECT/INSERT/UPDATE/DELETE、表管理、备份恢复等操作。当用户提及 MySQL、数据库查询、建表或数据备份时使用此技能。
-
serverTimezone=GMT或serverTimezone=Asia/Shanghai：统一服务端解释逻辑，推荐用GMT避免夏令时干扰 -
useLegacyDatetimeCode=false：强制启用新时间处理路径（8.0+ 默认为 true，必须显式关掉） - 完整示例：
jdbc:mysql://localhost:3306/test?serverTimezone=GMT&useLegacyDatetimeCode=false
代码中直接使用 setObject / getObject，不绕路
不用 java.util.Date 做中间转换，不手写 DateTimeFormatter，不依赖 MyBatis 的 @SelectProvider 拼字符串。
立即学习“Java免费学习笔记（深入）”；
- 写入：
ps.setObject(1, LocalDateTime.now()) - 读取：
LocalDateTime dt = rs.getObject("created_at", LocalDateTime.class) - MyBatis 用户：实体类字段用
LocalDateTime，Mapper XML 中无需typeHandler（8.0+ 自动识别） - 注意字段类型必须是
DATETIME（不是TIMESTAMP），否则可能触发隐式时区转换
区分 DATETIME 和 TIMESTAMP 的语义再选型
二者都存“年月日时分秒”，但行为完全不同，选错会导致上线后时间漂移。
-
DATETIME：纯字面值，存啥读啥，适合记录创建时间、截止时间等业务固定时刻 -
TIMESTAMP：自动转时区，存入时转为 UTC，读出时转回客户端时区，适合审计日志、最后更新时间等需全局一致的场景 - Java 端对应：
DATETIME → LocalDateTime，TIMESTAMP → Instant或ZonedDateTime（需配serverTimezone）
