Joda DateTime迁移ZonedDateTime报错，求正确JPA实体字段类型

报错原因 #

你遇到的错误是因为数据库中存储的时间格式2023-12-25T17:19:54.622Z属于带偏移量的UTC时间，对应Java 8的OffsetDateTime类型；而ZonedDateTime需要的是包含时区ID（如Europe/Paris）的时间，并非单纯的偏移量标识Z（代表UTC+0），JPA无法直接将偏移量时间转换为ZonedDateTime，因此抛出类型不匹配异常。

正确的字段类型与实现 #

方案1：使用OffsetDateTime（推荐，匹配现有数据格式） #

直接将字段类型改为OffsetDateTime，JPA（Hibernate 5.2+及以上版本）会自动支持该类型的映射，无需额外注解：

import java.time.OffsetDateTime;

@Entity
@Table(name = "purchases")
@Getter
@Setter
public class Purchases {

  @Column(name = "purchase_time")
  private OffsetDateTime purchaseTime;
}

方案2：继续使用ZonedDateTime（需配置类型映射） #

如果业务确实需要时区ID信息，可通过指定JPA的类型映射来解决。以Hibernate为例，需要添加@Type注解指定对应的类型处理器：

import java.time.ZonedDateTime;
import org.hibernate.annotations.Type;
import org.hibernate.annotations.TypeDef;

@Entity
@Table(name = "purchases")
@Getter
@Setter
// 定义ZonedDateTime的类型映射
@TypeDef(name = "zonedDateTime", typeClass = org.hibernate.type.ZonedDateTimeType.class)
public class Purchases {

  @Column(name = "purchase_time")
  @Type(type = "zonedDateTime")
  private ZonedDateTime purchaseTime;
}

注意：此方案需要确保数据库中存储的时间包含时区ID信息，若原有数据仅存偏移量，可能需要额外处理时区转换逻辑。

补充说明 #

• JPA 2.2及以上版本原生支持Java 8的日期时间类型（LocalDate、LocalTime、LocalDateTime、OffsetDateTime等），无需第三方依赖；
• ZonedDateTime由于包含时区ID，通常用于需要明确时区上下文的业务场景，若仅需记录UTC时间或带偏移量的时间，OffsetDateTime是更轻量且匹配度更高的选择。

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