Spring Boot+H2测试遇ClassCastException，求兼容DB2的非业务逻辑方案

在Spring Boot服务中通过createNativeQuery执行统计类原生查询时，常会遇到H2测试环境与DB2生产环境的类型不兼容问题：

• 直接强转Integer时，H2返回BigInteger触发ClassCastException
• 改为转换BigInteger取intValue()后，DB2返回Integer又出现反向转换异常
• 调整Hibernate方言、H2模式等配置后仍无法解决，且不想为适配测试环境添加业务逻辑分支

可行解决方案 #

1. 指定TypedQuery返回类型（推荐）

使用createNativeQuery时显式指定返回类型为Long.class，让Hibernate自动处理不同数据库的类型映射，统一转为Long后再转成Integer（需确保统计结果不会超出Integer范围，若数据量超大可直接返回Long）：

Query queryCount = em.createNativeQuery(sqlCount, Long.class);
return queryCount.getSingleResult().intValue();

此方案无需区分环境，Hibernate会自动适配DB2返回的Integer和H2返回的BigInteger，彻底避免类型转换异常。

2. 封装通用类型转换工具方法

编写一个工具方法统一处理两种类型的转换，业务代码无需关心底层数据库返回类型：

private Integer convertCountResult(Object result) {
    if (result instanceof Integer) {
        return (Integer) result;
    } else if (result instanceof BigInteger) {
        return ((BigInteger) result).intValue();
    }
    throw new IllegalArgumentException("不支持的统计结果类型: " + result.getClass().getName());
}

// 业务代码中调用
return convertCountResult(queryCount.getSingleResult());

该方法封装了类型判断逻辑，业务层无需添加环境分支，保持代码简洁。

3. 显式修改SQL语句强制返回Integer类型

在统计SQL中显式将结果转为Integer，让H2和DB2统一返回Integer类型：

-- 原SQL：SELECT COUNT(*) FROM your_table WHERE ...
-- 修改后：
SELECT CAST(COUNT(*) AS INTEGER) FROM your_table WHERE ...

此方案需要修改所有统计类SQL，适合SQL数量较少的场景。

为什么原有配置无效？ #

即使设置了org.hibernate.dialect.DB2Dialect和H2的MODE=DB2，H2与DB2的JDBC驱动对数值类型的底层映射仍存在差异，Hibernate方言无法完全覆盖这种驱动级别的类型返回差异，因此单纯调整配置无法解决问题。

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