BigDecimal.setScale 必须显式指定 roundingMode,否则抛 ArithmeticException;金融场景统一用 HALF_UP,禁用负 scale,setScale 不可逆且影响 equals 比较。

BigDecimal.setScale 的 roundingMode 参数必须显式指定
不传 roundingMode 会抛出 ArithmeticException,尤其在 JDK 8+ 中默认行为已收紧。金融场景绝不能依赖默认舍入逻辑,因为 setScale(int scale) 无参重载已被弃用且实际调用的是 HALF_UP,但该行为未写入契约,不同 JDK 版本或实现可能不一致。
实操建议:
- 始终使用双参数版本:
setScale(int newScale, RoundingMode mode) - 金融计息、结算、展示等场景统一用
RoundingMode.HALF_UP(即传统四舍五入) - 避免使用
RoundingMode.HALF_EVEN(银行家舍入),它虽减少统计偏差,但不符合国内会计准则和用户预期 - 若需截断(如手续费计算中“向下取整到分”),用
RoundingMode.DOWN,而非HALF_DOWN
scale 值为负数时的含义与误用风险
setScale(-1) 不是语法错误,而是合法操作:它表示将数值按 10 的幂次舍入,例如 new BigDecimal("123.45").setScale(-1, RoundingMode.HALF_UP) 得到 120(即精确到十位)。但在金融系统中极少需要这种尺度,一旦误写成负值,会导致金额被放大/缩小 10 倍级误差,且不易被日志或单元测试捕获。
常见错误现象:
- 账务对账差额为 10 的整数倍(如总差 30 元、120 元)
- 前端显示 “¥1,200.00”,但数据库存的是
120(因setScale(-2)把 12345 分转成 123 百元) - 单元测试用例覆盖了
scale=2,但生产环境配置读错成-2
建议:对所有 scale 输入做校验,禁止负值;配置项命名明确带单位,如 money_scale_in_cents = 2。
setScale 后的精度丢失不可逆,需在业务链路早期决策
setScale 是截断/舍入操作,不是格式化。一旦执行,原始精度信息永久丢失。例如 new BigDecimal("1.234567").setScale(2, RoundingMode.HALF_UP) 得到 1.23,后续再调 setScale(4, ...) 也无法恢复末两位。
使用场景差异:
- 记账入库前:必须用
setScale(2, RoundingMode.HALF_UP)确保数据库字段(如 DECIMAL(10,2))兼容 - 中间计算(如利率 × 本金 × 天数):应保持高精度(如 scale=6),仅在最终结果落库或返回前端前才缩放
- 前端展示:优先用
DecimalFormat或模板引擎格式化,而非提前setScale—— 避免重复舍入
compareTo 与 equals 在 setScale 后的行为陷阱
setScale 生成的新 BigDecimal 对象,其 equals 判断会比较值 *和* scale。例如:
new BigDecimal("1.20").setScale(2).equals(new BigDecimal("1.2")) // false
而 compareTo 只比大小,new BigDecimal("1.20").compareTo(new BigDecimal("1.2")) == 0 为 true。
这直接影响:
- Map 键查找失败(用
setScale(2)结果作 key,但查new BigDecimal("1.2")找不到) - AssertJ 或 JUnit 的
isEqualTo断言报错,即使数值相同 - MyBatis 插入时因 scale 不同触发冗余更新(乐观锁误判)
解决方案:业务对象中统一约定 scale(如所有金额字段初始化即 setScale(2, HALF_UP)),或比较前先标准化:a.setScale(2, HALF_UP).compareTo(b.setScale(2, HALF_UP)) == 0。
实际项目里最常被忽略的,是把 setScale 当作“格式化工具”混用在 DTO 构建、日志打印、Mock 数据生成等非落库环节——这些地方本不该引入精度变更。










