Hibernate+Spring：不改默认时区，实现UTC读写LocalDateTime时间戳

核心问题分析 #

你遇到的问题本质是：LocalDateTime本身不携带时区信息，Hibernate默认会把数据库存储的UTC时间，转换为JVM默认时区对应的LocalDateTime返回。即使配置了hibernate.jdbc.time_zone=UTC，这个配置仅作用于写入阶段，读取时的类型映射逻辑仍会走默认时区转换。

方案1：补充Hibernate类型配置（推荐） #

针对Hibernate 5.2+版本，直接在application.properties中添加以下配置，强制Hibernate处理Java 8时间类型时全程使用UTC时区映射：

spring.jpa.properties.hibernate.type.preferred_instant_jdbc_type=TIMESTAMP_UTC
spring.jpa.properties.hibernate.jdbc.time_zone=UTC

该配置会让Hibernate在读取数据库时间时，直接将UTC时间解析为LocalDateTime，不会转换到JVM默认时区。

方案2：自定义AttributeConverter（兼容旧版本） #

如果你的Hibernate版本较低，不支持上述配置，可以通过自定义属性转换器，强制指定时区转换逻辑：

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

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

    @Override
    public Timestamp convertToDatabaseColumn(LocalDateTime localDateTime) {
        return localDateTime == null ? null : 
               Timestamp.valueOf(localDateTime.atOffset(ZoneOffset.UTC).toLocalDateTime());
    }

    @Override
    public LocalDateTime convertToEntityAttribute(Timestamp timestamp) {
        return timestamp == null ? null : 
               timestamp.toInstant().atOffset(ZoneOffset.UTC).toLocalDateTime();
    }
}

• 设置autoApply=true可让转换器全局作用于所有LocalDateTime类型的实体属性；
• 转换逻辑：写入时将LocalDateTime视为UTC时间存入数据库，读取时直接把数据库的UTC时间解析为LocalDateTime，跳过JVM默认时区转换。

方案3：调整实体属性类型（可选） #

如果业务允许，可将实体属性类型从LocalDateTime改为OffsetDateTime，它本身携带时区信息，配合hibernate.jdbc.time_zone=UTC配置，Hibernate会自动正确处理UTC的存储和读取，无需额外转换。

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