Java BigDecimal 数值相同为什么 equals 返回 false

在金额、折扣或统计结果比较时，很多 Java 代码会把 BigDecimal("2.0") 和 BigDecimal("2.00") 当成同一个数，但调用 equals 却得到 false。这不是精度计算失控，而是两个方法判断的对象不同：equals 同时比较数值和 scale（小数位表示），compareTo 只比较数值大小。

为什么 equals 会把小数位也算进去

BigDecimal 可以看成“非缩放整数 + scale”的组合。下面的例子数值相同，但内部表示不同：

BigDecimal a = new BigDecimal("2.0");
BigDecimal b = new BigDecimal("2.00");

System.out.println(a.equals(b));       // false
System.out.println(a.compareTo(b));    // 0
System.out.println(a.scale());         // 1
System.out.println(b.scale());         // 2
System.out.println(a.unscaledValue()); // 20
System.out.println(b.unscaledValue()); // 200

Oracle 的 Java API 文档明确区分了这两个契约：equals 要求数值和 scale 都相同；compareTo 对不同 scale 但数值相等的对象返回 0。因此 equals 不是“写错了”，它保留了小数位这一表示信息，因为 2.0 和 2.00 在后续按精度进行除法、舍入时可能代表不同业务意图。

只判断数值时，直接使用 compareTo

价格是否相同、折扣是否为零、阈值是否达到，这些判断通常不关心输入保留了几位小数。推荐把比较写成：

BigDecimal expected = new BigDecimal("2.0");
BigDecimal actual = new BigDecimal("2.00");

if (actual.compareTo(expected) == 0) {
    System.out.println("数值相等");
}

if (amount.compareTo(BigDecimal.ZERO) > 0) {
    // amount 为正数
}

不要写 actual == expected。这是对象引用比较，即使两边 scale 完全一致，只要不是同一个对象也可能为 false。也不要为了让 equals 通过而到处删除小数位；那会把“输入表示”与“业务判等”混在一起，后续格式化、舍入和落库都更难检查。

生产代码应该怎样统一数值判等

先按字段含义决定规则，再选方法。可以用下面这张表作为代码审查清单：

如果字段合同就是“固定两位金额”，可以在进入领域对象时统一：

BigDecimal payable = input.setScale(2, RoundingMode.HALF_UP);
boolean same = payable.equals(new BigDecimal("12.30"));

如果只是需要生成不受尾随零影响的键，可以考虑 stripTrailingZeros()，但要记住它可能返回科学计数法形式的表示，例如 600.0 可能变成 scale 为负数的形式。键规范化应集中在一个方法里，并配套测试，不要在业务各处零散调用。

构造 BigDecimal 时避开 double 近似

比较结果异常有时不是 equals 的问题，而是构造入口已经引入了二进制浮点近似。不要把 0.1 直接传给构造器：

BigDecimal unsafe = new BigDecimal(0.1);
BigDecimal exactText = new BigDecimal("0.1");
BigDecimal readable = BigDecimal.valueOf(0.1);

System.out.println(unsafe);     // 可能带出很长的近似小数
System.out.println(exactText);  // 0.1
System.out.println(readable);   // 0.1

外部输入、数据库文本和表单金额优先按字符串解析；确实从 double 传入时使用 BigDecimal.valueOf，让意图更清楚。最终仍要根据字段合同选择 compareTo 或先 setScale 后 equals。

常见问题

BigDecimal 的 equals 和 compareTo 哪个更“正确”？

没有绝对答案。需要表示和 scale 都一致时用 equals，只关心数值大小时用 compareTo。

BigDecimal.ZERO.equals(new BigDecimal("0.00")) 为什么是 false？

BigDecimal.ZERO 的 scale 为 0，而 0.00 的 scale 为 2；数值相等但表示不同。数值判等改用 compareTo(...) == 0。

为什么 TreeSet 里可能放不下两个 BigDecimal？

TreeSet 依据自然顺序，也就是 compareTo。2.0 与 2.00 比较为 0，所以集合可能把它们视为同一个元素；这与 HashSet 依据 equals/hashCode 的行为不同。

把“数值相等”“表示相等”“集合去重”拆成三条明确规则，BigDecimal 的比较问题通常就能在代码审查阶段解决，而不是等金额数据进入线上后再追查。