Java 8向MySQL 5.7插入带毫秒精度的Instant时间失败求助

我之前也碰到过几乎一模一样的问题，你的表结构和代码逻辑本身没问题，核心问题出在JDBC驱动版本或者连接配置上，我来帮你一步步解决：

问题根源分析 #

你的test_table里timestamp字段是TIMESTAMP(3)，明确支持毫秒精度；代码里的Instant也已经截断到了毫秒级，但插入后数据库丢失了毫秒部分，大概率是JDBC驱动版本过低或者连接URL缺少关键参数，导致驱动没有正确把毫秒信息传递给MySQL。

具体解决方案 #

1. 升级MySQL JDBC驱动版本 #

MySQL 5.7需要搭配至少mysql-connector-java 5.1.37以上的版本（推荐用5.1.49或更高的5.x系列，8.x系列更适配MySQL 8.0，虽然兼容5.7但5.x稳定性更好）。旧版本驱动对TIMESTAMP精度的处理存在缺陷，无法正确传递毫秒级数据。

如果用Maven管理依赖，更新如下：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

2. 修改JDBC连接URL，添加关键参数 #

必须在连接URL中加上useLegacyDatetimeCode=false，这个参数会禁用驱动的旧日期时间处理逻辑，启用JDBC 4.2兼容的新逻辑，确保毫秒精度被正确传递。同时建议指定时区为UTC（和Instant的时区一致），避免时区转换带来的精度丢失：

// 替换成你的数据库地址、库名、账号密码
String url = "jdbc:mysql://localhost:3306/your_db?useLegacyDatetimeCode=false&serverTimezone=UTC&useSSL=false";

3. 优化代码：直接传递Instant（无需转Timestamp） #

从JDBC 4.2开始，Java 8的java.time类型（包括Instant）可以直接通过setObject传递给PreparedStatement，不需要手动转成java.sql.Timestamp，这样能减少转换过程中可能出现的精度损耗：

Instant instant = Instant.now().truncatedTo(ChronoUnit.MILLIS);
try (Connection conn = DbConnection.getCon();
     PreparedStatement ps = conn.prepareStatement("INSERT INTO test_table (timestamp) VALUES (?)")) {
    ps.setObject(1, instant); // 直接传入Instant即可
    ps.executeUpdate();
    LOG.info("Instant: {} and long: {}", instant, instant.toEpochMilli());
} catch (SQLException ex) {
    LOG.error("插入数据失败", ex); // 建议打印完整栈轨迹，方便排查深层问题
}

4. 验证配置与表结构 #

• 执行SQL确认表结构：DESC test_table;，确保timestamp字段确实是TIMESTAMP(3)类型。
• 检查MySQL时区设置：如果数据库时区不是UTC，可能会导致时间转换时丢失精度，建议设置为UTC：

SET GLOBAL time_zone = '+00:00';
SET time_zone = '+00:00';

测试验证 #

修改完成后重新插入数据，执行查询语句：

SELECT id, timestamp FROM test_table;

此时数据库中存储的时间应该会显示正确的毫秒后缀（比如2019-07-30 10:52:34.865）。

内容的提问来源于stack exchange，提问作者Ujjwal Jung Thapa