java中mysql的datetime字段与localdatetime映射需使用mysql connector/j 8.0+驱动并配置uselegacydatetimecode=false，通过setobject()和getobject(…, localdatetime.class)直接操作，字段类型必须为datetime且连接url应设servertimezone=gmt。
Java 中 MySQL 的 DATETIME 字段与 LocalDateTime 映射，核心在于 JDBC 驱动版本、连接参数配置和 PreparedStatement/ResultSet 的正确使用。只要驱动支持（MySQL Connector/J 8.0+），默认就能直连映射，无需额外转换。
确保使用新版 JDBC 驱动
MySQL 5.7 及以上 + LocalDateTime 要求 JDBC 驱动为 8.0.x 或更高版本。旧版（如 5.1.x）不支持 Java 8 时间类型，会抛出 SQLException 或自动转成 Timestamp。
- 推荐 Maven 依赖：
mysql
mysql-connector-java
8.0.33 - 避免混用 5.x 驱动 —— 即使数据库是 MySQL 8，用 5.1 驱动也会绕过
LocalDateTime支持。
配置连接 URL 启用时区与无时区解析
MySQL DATETIME 本身不带时区，但 JDBC 默认可能按服务器时区解释时间值。为避免意外偏移，建议显式配置：
- 添加参数：
?serverTimezone=UTC&useTimezone=false&noTimezoneConversion=true - 更稳妥写法（推荐）：
?serverTimezone=GMT&useLegacyDatetimeCode=false&allowPublicKeyRetrieval=true&useSSL=false -
useLegacyDatetimeCode=false是关键开关，启用新时间处理逻辑，让LocalDateTime直接对应DATETIME。
代码中读写 LocalDateTime 的标准方式
不用手动格式化字符串或转 Timestamp，JDBC 8+ 提供原生支持：
- 写入（PreparedStatement）：
ps.setObject(1, LocalDateTime.now());—— 直接传入，驱动自动映射到DATETIME - 读取（ResultSet）：
LocalDateTime dt = rs.getObject("create_time", LocalDateTime.class);
或简写：LocalDateTime dt = rs.getTimestamp("create_time").toLocalDateTime();（兼容写法，但推荐前者） - 注意：字段类型必须是
DATETIME（不是TIMESTAMP），否则可能触发时区转换逻辑。
常见问题与避坑提示
映射失败通常不是代码问题，而是环境配置偏差：
- 报错
Cannot convert class java.time.LocalDateTime→ 检查驱动版本和useLegacyDatetimeCode是否关闭 - 时间值相差 8 小时 → 连接 URL 缺少
serverTimezone或设成了本地时区（如Asia/Shanghai），而 MySQL 服务器实际用 UTC 存储 - MyBatis / JPA 场景下，确认 ORM 层未覆盖 JDBC 行为（例如 MyBatis 的 typeHandler 或 Hibernate 的
@Convert干预）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
