如何避免加载timestamp without time zone到LocalDateTime时受JVM时区影响

问题场景 #

数据库字段定义为timestamp without time zone，JPA实体对应LocalDateTime属性。用pgAdmin查询能得到正确时间，但通过pgjdbc驱动加载时，时间会被JVM/系统时区偏移，结果不符。比如系统时区为UTC+01:00时，数据库中存储的2018-03-25 02:00:00，驱动读取后变成2018-03-25 03:00:00。已知pgjdbc已修复LocalDateTime转数据库timestamp without time zone的问题，但反向转换的偏移问题仍存在。

可行解决方法 #

1. 调整JDBC连接参数 #

在JDBC URL中添加两个参数，强制驱动按字面量处理时间戳：

jdbc:postgresql://localhost:5432/your_db?useLegacyDatetimeCode=false&serverTimezone=UTC

useLegacyDatetimeCode=false会禁用旧的日期时间处理逻辑，serverTimezone=UTC指定统一时区，避免驱动用JVM时区做偏移转换。

2. 自定义JPA属性转换器 #

如果无法修改连接参数，可通过JPA自定义转换器，手动修正时区转换逻辑：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.time.LocalDateTime;
import java.time.OffsetDateTime;
import java.time.ZoneOffset;

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

    @Override
    public Object convertToDatabaseColumn(LocalDateTime localDateTime) {
        return localDateTime;
    }

    @Override
    public LocalDateTime convertToEntityAttribute(Object dbData) {
        if (dbData instanceof OffsetDateTime odt) {
            // 强制按UTC时区转换，抵消JVM时区的偏移影响
            return odt.withOffsetSameInstant(ZoneOffset.UTC).toLocalDateTime();
        }
        return (LocalDateTime) dbData;
    }
}

将该转换器添加到实体属性上（@Convert(converter = LocalDateTimeConverter.class)），或设置autoApply=true让所有LocalDateTime属性自动生效。

3. 升级pgjdbc驱动到最新稳定版 #

虽然已知反向转换问题有修复记录，但确认是否使用了包含完整修复的最新版本。pgjdbc后续版本可能已彻底解决timestamp without time zone转LocalDateTime的时区偏移问题，升级驱动是最直接的尝试方向。

问题根源说明 #

PostgreSQL的timestamp without time zone存储的是不带时区的字面时间，但旧版pgjdbc逻辑会错误地将其视为带时区的时间，用JVM系统时区做转换，导致时间偏移。上述方法要么让驱动直接按字面量处理，要么手动修正转换逻辑，确保读取的时间与数据库存储值一致。

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