Spring应用中Projection映射PostgreSQL时区时间为OffsetDateTime报错求助

问题核心是Hibernate默认将PostgreSQL的timestamp with time zone字段映射为Instant类型，而投影接口直接返回OffsetDateTime时，JPA没有内置转换逻辑，导致报错。以下是几种可行的解决方式：

方法1：在投影接口中使用SpEL表达式转换 #

直接在投影方法上通过Spring表达式语言（SpEL）将Instant转换为OffsetDateTime，可根据业务需求指定对应时区（示例为UTC）：

public interface MyProjection {
    @Value("#{target.createdAtDate.atOffset(java.time.ZoneOffset.UTC)}")
    OffsetDateTime getCreatedAtDate();
}

方法2：自定义AttributeConverter实现全局转换 #

创建JPA属性转换器，自动在Instant和OffsetDateTime间转换并全局应用：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.time.Instant;
import java.time.OffsetDateTime;
import java.time.ZoneOffset;

@Converter(autoApply = true)
public class InstantToOffsetDateTimeConverter implements AttributeConverter<Instant, OffsetDateTime> {
    @Override
    public OffsetDateTime convertToDatabaseColumn(Instant instant) {
        return instant != null ? instant.atOffset(ZoneOffset.UTC) : null;
    }

    @Override
    public Instant convertToEntityAttribute(OffsetDateTime offsetDateTime) {
        return offsetDateTime != null ? offsetDateTime.toInstant() : null;
    }
}

该转换器会自动作用于所有实体和投影的类型转换，无需额外配置。

方法3：配置Hibernate直接映射为OffsetDateTime #

修改JPA配置，让Hibernate将timestamp with time zone字段直接映射为OffsetDateTime：

spring:
  jpa:
    properties:
      hibernate:
        type:
          preferred_instant_jdbc_type: TIMESTAMP_WITH_TIMEZONE
          wrapper_proxy: true

同时确保实体类对应字段类型为OffsetDateTime，并显式指定列类型：

import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import java.time.OffsetDateTime;

@Entity
public class MyEntity {
    @Id
    private Long id;

    @Column(columnDefinition = "timestamp with time zone")
    private OffsetDateTime createdAtDate;

    // getter、setter方法
}

配置完成后，投影接口直接返回OffsetDateTime即可正常运行。

补充说明 #

你之前配置的hibernate.jdbc.time_zone: UTC仅用于设置JDBC连接时区，不会改变Hibernate默认的类型映射规则，因此无法解决投影时的类型转换问题。

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