使用Spring Data JDBC时MySQL Testcontainer时区问题求助

核心问题根源 #

即使MySQL容器已配置为UTC时区，JDBC驱动默认会使用JVM本地时区（你的MBP为UTC-0800）与数据库进行时间交互。当写入Instant转成的Timestamp时，驱动会自动将JVM时区的时间转换为数据库时区存储，最终导致数据库中存储的时间出现偏移，读取时也会因时区不匹配出现问题。

具体解决步骤 #

1. 显式指定JDBC连接时区 #

修改测试环境的JDBC URL，添加serverTimezone=UTC&useLegacyDatetimeCode=false参数，强制JDBC驱动以UTC时区与数据库交互：

spring.datasource.url=jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?serverTimezone=UTC&useLegacyDatetimeCode=false

2. 移除手动注册的Instant-Timestamp转换器 #

Spring Boot 3.x搭配Spring Data JDBC已内置java.time.Instant与数据库datetime(6)的映射支持，无需手动注册双向转换器。自定义转换器可能与默认实现冲突，导致读取逻辑失效。

3. 简化实体类时间字段定义 #

实体类中直接使用Instant类型定义时间字段，无需额外注解或转换：

@Column("created_at")
private Instant createdAt;

4. 测试环境自动设置JVM时区（可选） #

若不想手动添加JVM参数-Duser.timezone=UTC，可在测试启动时通过代码全局设置：

@BeforeAll
static void setupTestTimezone() {
    TimeZone.setDefault(TimeZone.getTimeZone("UTC"));
}

补充说明 #

• 自定义Clock Bean仅作用于业务代码中获取当前时间的逻辑，不会影响JDBC驱动的时区配置，因此无法解决该问题。
• 之前写入时确认的"UTC时间"是业务代码层面的Instant，但经过JDBC驱动时区转换后，实际存入数据库的是转换后的UTC-0800时间。

内容的提问来源于stack exchange，提问作者BtySgtMajor