Java BigDecimal 金额计算实战：避免浮点误差和舍入问题

订单金额、优惠券、运费、税费、提现余额，这些字段一旦算错，问题就不是页面展示难看，而是账务对不上。Java 里很多新人会直接用 double 做金额计算，测试时看起来没事，上线后却可能出现 0.30000000000000004 这类结果。

金额计算的原则很明确：不要用二进制浮点数承载精确十进制金额。本文用一个订单小计场景，讲清楚 BigDecimal 的正确用法、舍入方式、入库前处理和常见坑。

摘要

本文会先复现 double 金额误差，再用 BigDecimal 的字符串构造方式实现订单金额计算：单价乘数量、优惠抵扣、固定两位小数、明确舍入规则，最后给出适合接口层和数据库层的处理建议。

适合人群

• 正在写订单、支付、余额、发票等金额逻辑的 Java 开发者。
• 想系统理解 BigDecimal 构造、比较和舍入规则的后端同学。
• 已经掌握 Java 基础语法，希望减少线上金额问题的读者。

目录

1. double 为什么不适合金额计算
2. BigDecimal 的正确创建方式
3. 实现订单金额计算
4. 统一小数位和舍入规则
5. 比较金额不要直接用 equals
6. 常见坑和总结

一、double 为什么不适合金额计算

先看一个最小复现：

public class DoubleMoneyDemo {
    public static void main(String[] args) {
        double a = 0.1;
        double b = 0.2;
        System.out.println(a + b);
    }
}

输出很可能不是 0.3，而是：

0.30000000000000004

原因在于 double 使用二进制浮点表示，很多十进制小数无法精确表示。金额字段要求的是“分毫不差”，不是“差不多”。一旦订单小计、优惠抵扣、税费和四舍五入叠加，误差就可能被放大。

二、BigDecimal 的正确创建方式

BigDecimal 可以精确表示十进制数，但创建方式很关键。推荐使用字符串或 BigDecimal.valueOf。

import java.math.BigDecimal;

public class BigDecimalCreateDemo {
    public static void main(String[] args) {
        BigDecimal price1 = new BigDecimal("19.90");
        BigDecimal price2 = BigDecimal.valueOf(19.90);

        System.out.println(price1);
        System.out.println(price2);
    }
}

不要这样写：

BigDecimal price = new BigDecimal(19.90);

因为这个构造方法接收的是已经带有浮点表示误差的 double，会把误差一起带进 BigDecimal。

三、实现订单金额计算

假设有一个订单：单价 19.90 元，购买 3 件，优惠 5.00 元。可以这样算：

import java.math.BigDecimal;

public class OrderAmountDemo {
    public static void main(String[] args) {
        BigDecimal price = new BigDecimal("19.90");
        BigDecimal count = new BigDecimal("3");
        BigDecimal discount = new BigDecimal("5.00");

        BigDecimal subtotal = price.multiply(count);
        BigDecimal payable = subtotal.subtract(discount);

        System.out.println("subtotal = " + subtotal);
        System.out.println("payable = " + payable);
    }
}

输出：

subtotal = 59.70
payable = 54.70

这里的计算链路很清楚：字符串金额进入 BigDecimal，先乘数量得到小计，再减优惠，最后得到应付金额。每一步都保留十进制精度，不再受二进制浮点表示影响。

四、统一小数位和舍入规则

金额通常要保留两位小数，但不同业务的舍入规则可能不同。例如发票、结算、手续费可能会有各自规定。代码里必须明确写出来，不能依赖默认行为。

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

public class RoundDemo {
    public static void main(String[] args) {
        BigDecimal amount = new BigDecimal("10.235");

        BigDecimal rounded = amount.setScale(2, RoundingMode.HALF_UP);
        System.out.println(rounded);
    }
}

输出：

10.24

如果除法可能除不尽，也要指定小数位和舍入方式：

BigDecimal total = new BigDecimal("10.00");
BigDecimal count = new BigDecimal("3");

BigDecimal average = total.divide(count, 2, RoundingMode.HALF_UP);
System.out.println(average); // 3.33

五、比较金额不要直接用 equals

BigDecimal.equals 会比较数值和小数位，比如 1.0 和 1.00 用 equals 不一定相等。金额判断更常用 compareTo。

BigDecimal a = new BigDecimal("1.0");
BigDecimal b = new BigDecimal("1.00");

System.out.println(a.equals(b));       // false
System.out.println(a.compareTo(b) == 0); // true

判断金额是否大于零，也建议这样写：

if (amount.compareTo(BigDecimal.ZERO) > 0) {
    System.out.println("amount is positive");
}

六、常见坑和总结

1. 接口层不要直接接收 double 金额

接口参数可以用字符串接收金额，例如 "19.90"，进入服务层后再转换成 BigDecimal。这样能减少客户端和服务端之间的精度损失。

2. 数据库字段要用 DECIMAL

MySQL 中金额字段建议使用 DECIMAL(12,2) 这类精确十进制类型，不要用 FLOAT 或 DOUBLE 保存金额。

3. 统一封装金额工具

项目里可以封装金额创建、舍入、比较、格式化等方法，避免每个业务模块各写一套规则。

4. 舍入规则要和业务约定一致

不同业务可能不是简单四舍五入。涉及清分、结算、发票时，要先确认规则，再落到代码里。

总结一下：金额计算要从源头避免浮点误差。输入用字符串或整数分，计算用 BigDecimal，舍入显式指定 RoundingMode，比较用 compareTo，入库使用 DECIMAL。把这些规则固定下来，账务类问题会少很多。