Spring Boot 3升级后H2原生查询无法映射Instant字段求助

问题原因 #

升级后H2返回的时间类型为OffsetDateTime，但Spring Data JPA处理接口投影时，无法自动将OffsetDateTime转换为Instant，且未找到匹配的转换器，触发报错。

解决方案 #

方案1：自定义属性转换器 #

注册全局转换器，让Spring Data JPA在投影时自动完成类型转换：

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import java.time.Instant;
import java.time.OffsetDateTime;

@Component
public class OffsetDateTimeToInstantConverter implements Converter<OffsetDateTime, Instant> {
    @Override
    public Instant convert(OffsetDateTime source) {
        return source != null ? source.toInstant() : null;
    }
}

确保该类处于Spring组件扫描的包路径下。

方案2：修改原生查询，让H2返回兼容Instant的类型 #

在H2原生查询中，将时间字段转换为TIMESTAMP类型（H2的TIMESTAMP可直接映射为Java的Instant）：

@Query(value = "select id as id, CAST(time AS TIMESTAMP) as time from table", nativeQuery = true)
List<Projection> getMyProjection();

注：若time字段带时区信息，CAST操作会保留时间戳核心信息，转换为UTC对应的Instant。

方案3：用DTO类替代投影接口 #

定义DTO类，通过构造函数接收OffsetDateTime并转换为Instant，Spring Data JPA会自动匹配构造函数完成映射：

public class ProjectionDto {
    private final Long id;
    private final Instant time;

    public ProjectionDto(Long id, OffsetDateTime time) {
        this.id = id;
        this.time = time != null ? time.toInstant() : null;
    }

    // getter方法
    public Long getId() { return id; }
    public Instant getTime() { return time; }
}

修改Repository方法的返回类型：

@Query(value = "select id as id, time as time from table", nativeQuery = true)
List<ProjectionDto> getMyProjection();

方案4：临时修改投影接口返回类型（应急用） #

若业务允许，先将投影接口的getTime()返回类型改为OffsetDateTime，在业务代码中手动转换为Instant：

public interface Projection {
    Long getId();
    OffsetDateTime getTime();
    // 其他方法
}

业务层转换示例：

List<Projection> projections = repository.getMyProjection();
List<MyData> data = projections.stream()
    .map(p -> new MyData(p.getId(), p.getTime().toInstant()))
    .collect(Collectors.toList());

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