Spring Boot 3.2.1中hibernate.jdbc.time_zone配置失效问题

核心原因 #

Hibernate 6.4+ 对ZonedDateTime类型的处理逻辑发生了变更：

• 旧版本（6.1.x）中，hibernate.jdbc.time_zone会直接作用于ZonedDateTime的时区转换流程
• 新版本（6.4.x）中，ZonedDateTime默认会保留自身时区信息，不再强制应用hibernate.jdbc.time_zone配置，而是优先遵循JVM默认时区或字段自带的时区属性

修复方案 #

方案1：给实体字段添加时区转换注解 #

在ZonedDateTime字段上通过注解强制指定时区处理规则，覆盖默认逻辑：

@Column(name = "modified_date_time", insertable = false, columnDefinition = "datetime2")
@TimeZoneStorage(TimeZoneStorageType.NORMALIZE)
@ColumnTransformer(
    read = "CONVERT(datetime2, modified_date_time AT TIME ZONE 'Asia/Tehran')",
    write = "CONVERT(datetime2, ? AT TIME ZONE 'Asia/Tehran')"
)
private ZonedDateTime modifiedDateTime;

方案2：补充全局时区配置 #

在application.yaml中新增Hibernate全局时区配置，抵消JVM默认时区的影响：

spring:
  jpa:
    properties:
      hibernate:
        jdbc:
          time_zone: Asia/Tehran
        time_zone: Asia/Tehran # 新增该配置，全局强制指定时区

方案3：替换字段类型为LocalDateTime（推荐） #

SQL Server的datetime2本身不带时区信息，使用LocalDateTime更贴合数据库字段特性，避免时区转换歧义：

@Column(name = "modified_date_time", insertable = false, columnDefinition = "datetime2")
private LocalDateTime modifiedDateTime;

此时hibernate.jdbc.time_zone会正常将JVM的UTC时间转换为Asia/Tehran时区后存储到数据库。

验证步骤 #

1. 重启应用后插入测试数据，检查数据库中modified_date_time的存储值是否符合Asia/Tehran时区
2. 查看Hibernate启动日志，确认hibernate.jdbc.time_zone及新增配置已成功加载

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