Hibernate LocalDateTime与MySQL datetime转换：时区变更后如何保留原日期

这问题我之前也碰到过——LocalDateTime本身是不带时区信息的，MySQL的datetime字段同样也是无时区存储的，但修改应用默认时区后，Hibernate却会莫名其妙给LocalDateTime字段应用偏移量，导致读出来的时间和数据库里存的不一样。下面几个方法可以帮你彻底解决这个问题，强制获取数据库里的原始日期：

1. 配置Hibernate的JDBC时区，禁用自动转换 #

最直接的方式是显式告诉Hibernate，处理日期时间时使用固定时区（比如UTC），避免它跟着应用默认时区走。这样LocalDateTime字段就不会被无端转换。

如果是Spring Boot项目，在application.properties里加这行：

spring.jpa.properties.hibernate.jdbc.time_zone = UTC

如果是传统Hibernate配置（比如hibernate.cfg.xml），则添加：

<property name="hibernate.jdbc.time_zone">UTC</property>

原理是：让Hibernate在处理无时区的LocalDateTime时，用UTC作为基准时区，跳过任何基于默认时区的偏移计算，直接映射数据库里的原始值。

2. 自定义属性转换器，强制无转换映射 #

如果上面的配置没生效，你可以写一个自定义的属性转换器，直接在LocalDateTime和SQL Timestamp之间做纯值转换，完全绕过时区处理。

创建这个转换器类：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.sql.Timestamp;
import java.time.LocalDateTime;

@Converter(autoApply = true)
public class LocalDateTimeConverter implements AttributeConverter<LocalDateTime, Timestamp> {

    @Override
    public Timestamp convertToDatabaseColumn(LocalDateTime localDateTime) {
        // 直接把LocalDateTime转成Timestamp，不碰时区
        return localDateTime != null ? Timestamp.valueOf(localDateTime) : null;
    }

    @Override
    public LocalDateTime convertToEntityAttribute(Timestamp timestamp) {
        // 直接把Timestamp转回LocalDateTime，跳过时区偏移
        return timestamp != null ? timestamp.toLocalDateTime() : null;
    }
}

加上@Converter(autoApply = true)后，这个转换器会自动应用到所有LocalDateTime字段上，确保读写都是纯值转换，不会有任何时区干扰。

3. 修正MySQL JDBC连接的时区配置 #

有时候问题出在JDBC驱动层面——驱动会根据默认时区自动转换datetime值。你可以在连接URL里明确指定时区，避免这种自动转换：

jdbc:mysql://localhost:3306/your_database?useTimezone=true&serverTimezone=UTC&useLegacyDatetimeCode=false

这里的serverTimezone=UTC告诉驱动，处理数据库的datetime时用UTC时区解析，而不是应用的默认时区，这样就能保证读出来的就是数据库里存的原始时间。

额外说明 #

LocalDateTime的设计初衷就是处理无时区的本地时间，所以最佳实践是：尽量不要让默认时区的变化影响到LocalDateTime字段的读写。上面的方法都是围绕这个核心，要么让Hibernate/驱动固定时区，要么直接跳过时区转换，确保你拿到的就是数据库里的原始值。

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