Hibernate映射OffsetDateTime如何保留PostgreSQL timestamptz时区？

问题核心：Hibernate默认的OffsetDateTimeJavaDescriptor会用系统默认时区转换java.sql.Timestamp，而PostgreSQL的timestamptz存储的是UTC时间，导致实体类中的OffsetDateTime时区被替换为系统时区。以下是三种可行解决方案：

方案一：自定义Hibernate类型（精准控制转换逻辑） #

直接替换默认的OffsetDateTime处理逻辑，强制使用UTC时区：

1. 自定义Java描述器，重写wrap方法

public class UtcOffsetDateTimeJavaDescriptor extends OffsetDateTimeJavaDescriptor {
    @Override
    public Object wrap(Object value, WrapperOptions options) {
        if (value == null) return null;
        
        if (value instanceof Timestamp) {
            Timestamp ts = (Timestamp) value;
            // 强制使用UTC时区，替换系统默认
            return OffsetDateTime.ofInstant(ts.toInstant(), ZoneOffset.UTC);
        }
        
        if (value instanceof java.util.Date) {
            java.util.Date date = (java.util.Date) value;
            return OffsetDateTime.ofInstant(date.toInstant(), ZoneOffset.UTC);
        }
        
        throw unknownWrap(value.getClass());
    }
}

2. 自定义类型描述器关联上述Java描述器

public class UtcOffsetDateTimeTypeDescriptor extends OffsetDateTimeTypeDescriptor {
    public static final UtcOffsetDateTimeTypeDescriptor INSTANCE = new UtcOffsetDateTimeTypeDescriptor();

    @Override
    public JavaTypeDescriptor<OffsetDateTime> getJavaTypeDescriptor() {
        return new UtcOffsetDateTimeJavaDescriptor();
    }
}

3. 在实体类中使用自定义类型
   要么单独字段指定：

@Entity
public class MyTable {
    // 其他字段...
    @Type(type = "com.your.package.UtcOffsetDateTimeTypeDescriptor")
    private OffsetDateTime timestamptzCol;
}

要么全局注册（Hibernate 5.3+）：

@TypeDef(
    name = "utc-offset-datetime",
    defaultForType = OffsetDateTime.class,
    typeClass = UtcOffsetDateTimeTypeDescriptor.class
)
@Entity
public class MyTable {
    // 其他字段...
    private OffsetDateTime timestamptzCol;
}

方案二：全局配置Hibernate时区（最简单高效） #

直接在Hibernate配置中指定全局时区为UTC，让默认转换逻辑使用UTC而非系统时区：

• Spring Boot的application.properties：

hibernate.jdbc.time_zone=UTC

• 原生Hibernate的hibernate.cfg.xml：

<session-factory>
    <!-- 其他配置 -->
    <property name="hibernate.jdbc.time_zone">UTC</property>
</session-factory>

这个配置会影响所有日期时间类型的处理，从根源上避免系统时区干扰。

方案三：配置JDBC连接时区（配合方案二更佳） #

在PostgreSQL JDBC连接URL中强制指定时区为UTC，确保驱动返回的Timestamp对应UTC时间：

jdbc:postgresql://localhost:5432/your_database?serverTimezone=UTC&useTimezone=true

结合方案二的Hibernate时区配置，形成双重保障，彻底解决时区不一致问题。

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