Hibernate存储OffsetTime至PostgreSQL带时区时间字段的异常绑定问题

核心原因：PostgreSQL time with time zone 的设计限制 #

首先要明确：PostgreSQL的time with time zone（简称timetz）类型本身不会保留输入的原始时区偏移。它的工作逻辑是：将所有输入的时间值转换为数据库服务器的默认时区，然后存储转换后的时间，再关联数据库时区的偏移。这是PostgreSQL的原生设计，和Hibernate无关。

Hibernate 5.6.1 的默认处理逻辑 #

Hibernate默认的OffsetTimeJavaDescriptor和TimeTypeDescriptor组合，会把OffsetTime转换为JVM默认时区的LocalTime，再通过JDBC的TIME类型绑定到数据库。而PostgreSQL的JDBC驱动遇到timetz字段时，如果传入的是无偏移的LocalTime，会自动用数据库时区补全偏移，这就导致你看到的所有值都统一变成了默认时区对应的偏移格式，原始偏移完全丢失。

回到你的问题：是否必须转换为默认时区？ #

不是必须，但要先明确你要的“正确存储”是什么：

• 如果业务只关心时间值在默认时区的正确性，不要求保留原始偏移，那么转换为默认时区存储是可行的（这也是StackOverflow建议的妥协方案），但本质上还是丢失了原始偏移信息。
• 如果业务需要保留原始时区偏移，那么timetz字段根本满足不了需求，必须换存储方案：
  • 方案1：改用timestamp with time zone（timestamptz）字段，虽然它是日期+时间+偏移类型，但可以存储OffsetTime对应的瞬时时间点（比如绑定当天日期），取出时再还原为OffsetTime。
  • 方案2：拆分存储，用两个字段分别存LocalTime（时间值）和varchar/smallint（时区偏移，比如+08或480分钟），读取时再组合成OffsetTime。
  • 方案3：自定义Hibernate类型，直接将OffsetTime的时间值和偏移量以字符串形式存储（比如12:34:56+05），但需要自己实现类型转换逻辑。

针对Hibernate的优化配置（如果坚持用timetz） #

如果你不需要保留原始偏移，只是想让Hibernate正确处理时间转换，可以在实体属性上显式指定类型映射：

@Column(columnDefinition = "time with time zone")
@Type(type = "org.hibernate.type.OffsetTimeType")
private OffsetTime offsetTime;

这种配置下，Hibernate会直接将OffsetTime转换为JDBC的TIME_WITH_TIMEZONE类型（如果驱动支持），但PostgreSQL依然会将其转换为数据库时区存储，原始偏移还是会丢失——这是数据库类型的限制，无法绕过。

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