如何阻止Hibernate持久化PostgreSQL timestamp with time zone时将ZonedDateTime转UTC

问题根源 #

你遇到的问题核心和Hibernate配置无关，是PostgreSQL timestamp with time zone（简称timestamptz）类型的固有特性导致的：该类型并不会存储原始输入的时区信息，写入时会自动将带时区的时间转换为UTC时间存储，读取时再根据当前数据库会话的时区转换为对应时区的时间，原始时区信息会被直接丢弃。

可行解决方案 #

方案1：双字段存储（最推荐，兼容当前环境） #

这个方案可以保留数据库的时间查询、计算能力，同时完整保留原始时区信息，代码侵入性极低：

1. 修改数据表结构，新增时区存储字段：

alter table my_type add column time_zone varchar(64);

2. 调整实体类实现，拆分ZonedDateTime为两个字段存储，对外仍暴露ZonedDateTime操作接口：

@Entity
public class MyType{
    @Id
    @GeneratedValue(generator = "uuid2")
    @Type(type = "uuid-char")
    @GenericGenerator(name = "uuid2", strategy = "uuid2")
    private UUID id;

    // 存储UTC时间，对应原有timestamptz类型的time字段
    @Column(name = "time")
    private Instant utcTime;

    // 存储原始时区ID，比如Asia/Shanghai、America/New_York
    @Column(name = "time_zone")
    private String zoneIdStr;

    // 对外暴露的ZonedDateTime读写方法，不会直接持久化
    @Transient
    public ZonedDateTime getTime() {
        return ZonedDateTime.ofInstant(utcTime, ZoneId.of(zoneIdStr));
    }

    public void setTime(ZonedDateTime time) {
        this.utcTime = time.toInstant();
        this.zoneIdStr = time.getZone().getId();
    }

    public MyType(){}
    // 省略其他getter、setter
}

上层业务代码无需修改，仍然直接调用setTime()/getTime()操作ZonedDateTime实例即可，完全可以保留不同实例的自定义时区。

方案2：存储ISO 8601格式字符串 #

如果你不需要在数据库层面做时间范围查询、时间计算等操作，也可以直接将ZonedDateTime序列化为带时区的ISO 8601字符串存储：

1. 修改数据表字段类型：

alter table my_type alter column time type text;

2. 实体类调整实现：

@Column
private String time;

@Transient
public ZonedDateTime getTime() {
    return ZonedDateTime.parse(time, DateTimeFormatter.ISO_ZONED_DATE_TIME);
}

public void setTime(ZonedDateTime time) {
    this.time = time.format(DateTimeFormatter.ISO_ZONED_DATE_TIME);
}

该方案实现简单，但损失了数据库的时间操作能力，适合仅需要存储、不需要数据库层面时间计算的场景。

补充说明 #

hibernate.jdbc.time_zone配置仅能指定Hibernate和JDBC交互时的全局会话时区，无法实现不同实例保留不同时区的需求，因为底层PG的timestamptz类型本身就不存储原始时区信息，调整该配置无法解决你的问题。

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