Spring Boot 3 Data JPA原生查询数据类型映射异常问题

问题根源 #

Hibernate 6（Spring Boot 3默认依赖）对原生查询的结果集处理逻辑做了重大调整：

• 新增基于列语义的自动类型推断：对于NUMBER(1,0)这类常用于存储布尔值的列，会自动映射为Boolean类型
• 对未指定精度的NUMBER列，Hibernate会优先依据JDBC驱动返回的底层类型标识（如Oracle内部的FLOAT码），将其映射为Float，而非Hibernate文档中标注的默认BigDecimal

这和Spring Boot 2使用的Hibernate 5逻辑完全不同——Hibernate 5对原生查询的所有数值类型默认统一映射为BigDecimal。你用纯JDBC测试正常，是因为JDBC驱动本身严格遵循Oracle文档的规则，而Hibernate 6在结果集之上做了额外的类型转换处理。

恢复原有行为的三种方法 #

1. 全局启用Legacy模式（推荐） #

通过配置让Hibernate 6退回到Hibernate 5的原生查询结果处理逻辑，全局强制所有数值类型映射为BigDecimal：
在application.properties中添加：

hibernate.query.native_resultset_handling_mode=LEGACY

或者application.yml格式：

hibernate:
  query:
    native_resultset_handling_mode: LEGACY

2. 针对单个查询显式指定类型 #

如果不想全局修改，可以在原生查询中通过addScalar强制指定列的映射类型：

List<Object[]> results = entityManager.createNativeQuery("SELECT id, flag, amount FROM your_table")
    .addScalar("id", StandardBasicTypes.LONG)
    .addScalar("flag", StandardBasicTypes.BIG_DECIMAL) // 强制NUMBER(1,0)映射为BigDecimal
    .addScalar("amount", StandardBasicTypes.BIG_DECIMAL) // 强制NUMBER映射为BigDecimal
    .getResultList();

如果是返回DTO对象，可配合@SqlResultSetMapping定义字段类型：

@SqlResultSetMapping(
    name = "YourDTOMapping",
    classes = @ConstructorResult(
        targetClass = YourDTO.class,
        columns = {
            @ColumnResult(name = "id", type = Long.class),
            @ColumnResult(name = "flag", type = BigDecimal.class),
            @ColumnResult(name = "amount", type = BigDecimal.class)
        }
    )
)

// 查询时使用映射
List<YourDTO> results = entityManager.createNativeQuery(
    "SELECT id, flag, amount FROM your_table", 
    "YourDTOMapping"
).getResultList();

3. 自定义全局类型映射 #

需要更细粒度控制时，可自定义Hibernate类型贡献器，强制Oracle所有NUMBER类型映射为BigDecimal：
首先实现自定义类型：

public class OracleBigDecimalType extends BigDecimalType {
    @Override
    public String getName() {
        return "oracle_big_decimal";
    }

    @Override
    public boolean isDefault(Column column) {
        // 匹配Oracle所有NUMBER类型列
        return "NUMBER".equalsIgnoreCase(column.getType());
    }
}

然后实现类型贡献器：

public class OracleTypeContributor implements TypeContributor {
    @Override
    public void contribute(TypeContributions contributions, ServiceRegistry registry) {
        contributions.contributeType(new OracleBigDecimalType());
    }
}

最后在配置中注册：

hibernate.type_contributors=com.your.package.OracleTypeContributor

验证 #

修改配置或代码后，执行原生查询，通过result.getClass()打印返回值类型，确认是否恢复为BigDecimal。

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