如何将Oracle带时区Timestamp列映射到Java投影类？

问题根源 #

报错No Dialect mapping for JDBC type: -101是因为Oracle的TIMESTAMP(6) WITH TIME ZONE对应的JDBC类型码为-101，Hibernate默认方言未正确映射该类型到Java类型，同时原生查询的列名与投影接口的方法名不匹配也会加剧这个问题。

步骤1：修正原生查询的列别名 #

数据库列名为creation_date，而投影接口的方法是getCreationDate()，需要在查询中给列添加别名匹配驼峰命名：

@Query(value = "select id, age, name, creation_date AS creationDate FROM Person WHERE age=?1", nativeQuery=true)
List<PersonView> getPersonsByAge(int age);

步骤2：配置支持时区Timestamp的Oracle方言 #

确保使用Hibernate针对Oracle 12c及以上版本的方言，这类方言已内置TIMESTAMP WITH TIME ZONE与JavaOffsetDateTime/ZonedDateTime的映射：
在application.properties（或application.yml）中添加：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.Oracle12cDialect

步骤3：旧版Hibernate需自定义方言注册类型映射 #

如果使用Hibernate 5.2之前的版本，需要自定义方言显式注册类型映射：

public class CustomOracleDialect extends Oracle12cDialect {
    public CustomOracleDialect() {
        super();
        registerHibernateType(Types.TIMESTAMP_WITH_TIMEZONE, OffsetDateTimeType.INSTANCE.getName());
    }
}

然后将配置文件中的方言替换为自定义类：

spring.jpa.properties.hibernate.dialect=com.yourpackage.CustomOracleDialect

步骤4：改用带结果集映射的实现类投影（若上述方法无效） #

接口投影在原生查询的类型映射上存在限制，可改用实现类配合@SqlResultSetMapping：

1. 创建投影实现类：

public class PersonViewImpl implements PersonView {
    private final Long id;
    private final Integer age;
    private final String name;
    private final OffsetDateTime creationDate;

    public PersonViewImpl(Long id, Integer age, String name, OffsetDateTime creationDate) {
        this.id = id;
        this.age = age;
        this.name = name;
        this.creationDate = creationDate;
    }

    @Override
    public Long getId() { return id; }
    @Override
    public Integer getAge() { return age; }
    @Override
    public String getName() { return name; }
    @Override
    public OffsetDateTime getCreationDate() { return creationDate; }
}

2. 定义结果集映射（可放在任意被Hibernate扫描到的实体类上）：

@SqlResultSetMapping(
    name = "PersonViewMapping",
    classes = @ConstructorResult(
        targetClass = PersonViewImpl.class,
        columns = {
            @ColumnResult(name = "id", type = Long.class),
            @ColumnResult(name = "age", type = Integer.class),
            @ColumnResult(name = "name", type = String.class),
            @ColumnResult(name = "creationDate", type = OffsetDateTime.class)
        }
    )
)
@Entity
public class Person {
    // 实体类原有字段与注解
}

3. 修改查询指定结果集映射：

@Query(value = "select id, age, name, creation_date AS creationDate FROM Person WHERE age=?1", nativeQuery=true, resultSetMapping="PersonViewMapping")
List<PersonViewImpl> getPersonsByAge(int age);

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