根本原因是Java基本类型(int、long)不能容纳null,而Oracle NUMBER列允许为空;JDBC返回BigDecimal,但ORM框架将NULL静默转为0或抛异常,故实体类必须用Integer、Long、BigDecimal等包装类型。

Oracle NUMBER字段为什么取出来是null或0而不是真实值
根本原因是Java基本类型(int、long)不能容纳null,而Oracle的NUMBER列允许为空。JDBC驱动返回BigDecimal,但ORM框架(如MyBatis、Hibernate)在自动映射时,若Java字段声明为int或long,遇到数据库NULL就会静默填入默认值0,或直接抛NullPointerException。
- 实体类字段必须用包装类型:
Integer、Long、BigDecimal,绝不能用int、long - MyBatis中显式指定
javaType="java.math.BigDecimal",避免依赖默认推断 - Spring JDBC的
BeanPropertyRowMapper不会自动处理null→0转换,但若字段类型是基本类型,反射设值会失败——必须改用包装类 - 如果业务层真要转
int,先判空再调bigDecimal.intValueExact(),它会在溢出或含小数时明确抛ArithmeticException
getBigDecimal()和getLong()哪个该用
一律优先用getBigDecimal()。Oracle JDBC驱动对NUMBER的类型推测不可靠:旧版驱动(如ojdbc6)可能把NUMBER(38)错判为Long,导致数值截断;即使ojdbc8+,也仅在scale == 0且precision ≤ 18时才稳妥映射为Long,但业务数据往往不满足这个前提。
-
rs.getLong("col")在值超过Long.MAX_VALUE(约9×10¹⁸)时会静默溢出或抛SQLException: Numeric Overflow -
rs.getBigDecimal("col")始终安全,无论NUMBER(5,2)还是NUMBER(38) - 如需
Long,应在拿到BigDecimal后调bigDecimal.longValueExact(),它会在超范围或有小数时立刻报错,而非掩盖问题 - 全局加固:连接创建后立即执行
connection.unwrap(OracleConnection.class).setForceBigDecimals(true),或JDBC URL加?oracle.jdbc.javaNumber=true
BigDecimal的scale为什么和数据库定义不一致
Oracle的NUMBER(p,s)只约束存储精度,不强制JDBC返回的BigDecimal保留s位小数。例如NUMBER(5,2)存123.00,getBigDecimal()可能返回123(scale=0),而非123.00(scale=2)。这不是bug,而是JDBC按数值本身“最简表示”返回。
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 金额类字段必须主动规整:用
bigDecimal.setScale(2, RoundingMode.HALF_UP),别指望数据库定义自动生效 - 整数ID类字段(如
NUMBER(19,0))若被ORM误设scale=0,可能导致compareTo()异常——此时检查MyBatis是否用了jdbcType=NUMERIC而非jdbcType=DECIMAL,二者处理scale逻辑不同 - JSON序列化前务必调
setScale(),否则前端收到123和123.00会被视为不同值 - 避免用
new BigDecimal(double)构造,比如new BigDecimal(rs.getDouble("col"))——double已失真,补救无效
MyBatis里NUMBER字段映射成Boolean怎么办
Oracle没有原生BOOLEAN类型,所谓“布尔字段”实际是NUMBER(1)(存0/1)、CHAR(1)(存'Y'/'N')等模拟类型。JDBC不识别这些为布尔,ResultSet.getBoolean()行为不可靠,可能返回false即使数据库存的是1。
立即学习“Java免费学习笔记(深入)”;
- 不要在MyBatis的
<result>中省略jdbcType,必须写明jdbcType="NUMERIC"或jdbcType="CHAR" - 自定义
TypeHandler<Boolean>:重写getNullableResult(),先rs.getInt()再判断是否为1,并用rs.wasNull()区分NULL和0 - 全局注册时,
jdbcType别配"BIT"——Oracle不用BIT,配了也触发不到 - JPA/Hibernate场景下,必须用
@Convert或@Type(type = "yes_no"),不能仅靠@Column
setScale(),而不是等着数据库或框架“应该”做对。

















