Java BigDecimal计算金额时的舍入规则清单

Java金额计算最稳妥的做法不是“最后统一保留两位小数”，而是从输入、运算到输出都明确精度责任：用字符串或整数构造BigDecimal，在需要改变小数位时使用setScale(scale, RoundingMode)，除法直接指定商的scale和舍入模式。BigDecimal不可变，setScale返回新对象，忘记接收返回值也是常见错误。

Java BigDecimal先固定输入构造方式和scale责任

BigDecimal的数值和scale是两个相关但不等价的概念。比如10.00与10.0数值相等，但小数位不同。金额对象进入业务层时，先约定“内部计算精度”和“账务展示精度”，不要让每个调用点自行决定。

import java.math.BigDecimal;
import java.math.RoundingMode;

BigDecimal price = new BigDecimal("19.995"); // 用字符串保留十进制输入
BigDecimal fee = price.multiply(new BigDecimal("0.075")); // 中间结果暂不急着舍入
BigDecimal payable = fee.setScale(2, RoundingMode.HALF_UP); // 结算边界统一到两位
System.out.println(payable); // 结果示意：1.50

如果输入来自表单或JSON，先按字符串解析；如果只能接收double，可使用BigDecimal.valueOf，但更好的接口仍是直接传递十进制文本。金额对象每次变换精度都要接住返回值，原对象不会被修改。

按业务含义选择RoundingMode舍入规则

舍入模式不是格式化选项，而是业务规则。Oracle API将HALF_EVEN定义为遇到正中间值时取偶数邻居；它能降低大量重复计算中的累计偏差。传统票据常使用HALF_UP，而对“不能产生任何舍入”的字段，应使用UNNECESSARY让异常暴露出来。

负数还会暴露模式差异：CEILING向正无穷方向，FLOOR向负无穷方向；退款、折扣和税额不能只看正数样例。建议把“谁承担最后一分钱”写入业务说明，而不是在代码里凭习惯选常量。

在除法和中间结果处显式给出scale

直接调用divide(BigDecimal)要求商能表示为有限小数，1.divide(3)会抛出ArithmeticException。金额分摊应显式指定商的位数和规则，并根据业务决定是每行先舍入，还是保留更多中间位后在汇总边界舍入。

BigDecimal total = new BigDecimal("10.00");
BigDecimal people = new BigDecimal("3");
BigDecimal share = total.divide(people, 6, RoundingMode.HALF_EVEN); // 中间分摊保留6位
BigDecimal invoiceShare = share.setScale(2, RoundingMode.HALF_UP); // 发票金额再落到2位

“中间六位、最终两位”只是示例，不是所有币种的固定答案。若逐行舍入后再求和，结果可能与总额直接舍入不同；这时要建立尾差分配策略，例如将余数交给最后一行，并在账务日志中记录分配规则。

用UNNECESSARY和集中策略守住金额边界

对于要求最多两位小数的输入，可以先用UNNECESSARY检查，再按展示规则格式化。这样“多了一位小数”不会被静默吞掉，调用方可以返回明确的参数错误。

static BigDecimal requireMoneyScale(String text) {
    BigDecimal value = new BigDecimal(text); // 保留调用方传入的十进制语义
    try {
        return value.setScale(2, RoundingMode.UNNECESSARY); // 多余非零位直接失败
    } catch (ArithmeticException ex) {
        throw new IllegalArgumentException("金额最多保留两位小数", ex); // 转成业务可识别异常
    }
}

生产代码可以集中提供money、divideForAllocation等小方法，把scale和舍入模式放在命名清楚的策略位置。不要混用已废弃的整数舍入常量；新代码优先使用类型安全的RoundingMode枚举。

用表格和测试样例复核规则落地

最少覆盖四类样例：普通值、恰好半数、负数和除不尽结果。断言时同时关注数值和scale，因为2.00在展示与序列化层面可能不能等同于2。

常见问题

BigDecimal.setScale会修改原变量吗？

不会。它返回带新scale的BigDecimal，必须写成value = value.setScale(2, mode)或接收另一个变量。

金额计算一定要使用HALF_UP吗？

不一定。收款、税费、统计和分摊的规则可能不同，先确认业务约定，再选择HALF_UP、HALF_EVEN或其他模式。

为什么divide有时会抛ArithmeticException？

不带舍入参数的除法遇到无限循环小数无法精确表示；给出目标scale和RoundingMode即可把这条边界变成显式规则。