Java BigDecimal equals 为何和 compareTo 不一致

Java 里把两个看起来相同的金额或小数直接调用 equals，结果可能和 compareTo 不一样。原因不是 BigDecimal 比较失灵，而是两种方法回答了不同问题：equals 同时比较数值和 scale，compareTo 只比较数值。因此 new BigDecimal("2.0") 与 new BigDecimal("2.00") 的数值相等，但表示不完全相同。

判断“金额是否相等”通常用 a.compareTo(b) == 0；只有当小数位数本身也是业务信息时，才使用 equals。集合场景还要单独考虑 HashSet 与 TreeSet 的去重规则。

为什么 2.0 和 2.00 的 equals 结果不同

BigDecimal 可以理解为“未缩放整数 + scale”的十进制表示。2.0 和 2.00 都表示数值 2，但小数位分别是 1 位和 2 位。Oracle API 对 equals 的定义就是数值和 scale 都相同才返回 true；compareTo 则把不同 scale 但数值相同的对象视为同一数值。

这也解释了为什么不能把 compareTo 的 0 直接等同于 equals 的 true。Comparable 的自然排序通常和 equals 一致，但 BigDecimal 是一个明确的例外，调用方要把业务语义写出来。

按数值相等改用 compareTo

如果需求是判断价格、余额、折扣或阈值的数值是否相等，应该比较 compareTo 的返回值，而不是比较对象引用，也不要用 equals 代替数值判断。

import java.math.BigDecimal;

public class DecimalComparison {
    public static boolean sameAmount(BigDecimal left, BigDecimal right) {
        // compareTo 只比较数值，2.0 与 2.00 会返回 0。
        return left != null && right != null && left.compareTo(right) == 0;
    }

    public static boolean notOverLimit(BigDecimal amount, BigDecimal limit) {
        // 小于或等于上限时返回 true；用 compareTo 表达数值边界。
        return amount != null && limit != null && amount.compareTo(limit) 

小于、大于判断同理：使用 compareTo(...) 、> 0 或 。如果参数允许为空，先决定空值是业务缺失还是默认值，不能让空值策略隐藏在比较方法里。

按表示相等保留 equals

有些业务确实关心小数位，例如导入文件时要判断原始格式是否被改写，或测试序列化结果是否保留了 scale。这时 2.0 和 2.00 就不是可互换的表示，equals 反而更符合需求。

如果只是希望统一表示后再比较，可以在边界处制定规范，例如统一保留两位小数后再进入领域对象。但 stripTrailingZeros() 会改变 scale，不能把它当作无条件的“修复 equals”方法；它适合明确要消除尾随零的场景。构造十进制值时也尽量使用字符串：

BigDecimal fromText = new BigDecimal("0.10");
BigDecimal fromDouble = BigDecimal.valueOf(0.10d);

// 字符串直接表达十进制；valueOf 使用 double 的规范字符串表示。
boolean sameNumber = fromText.compareTo(fromDouble) == 0;

不要用 new BigDecimal(0.1d) 作为金额字面量，它会把二进制浮点数的实际尾数带进 BigDecimal，产生与直觉不同的十进制展开。

集合去重时为什么 HashSet 和 TreeSet 表现不同

BigDecimal 的差异在集合中更容易被放大。HashSet 通过 equals 和 hashCode 判断元素是否等价，所以 2.0 与 2.00 通常可以同时存在；TreeSet 使用自然排序的 compareTo，当比较结果为 0 时会把它们视作同一个排序元素。

Set hashSet = new HashSet();
Set treeSet = new TreeSet();

BigDecimal oneDecimal = new BigDecimal("2.0");
BigDecimal twoDecimals = new BigDecimal("2.00");

// 两种集合使用的等价关系不同，不能混用 size 的业务含义。
hashSet.add(oneDecimal);
hashSet.add(twoDecimals);
treeSet.add(oneDecimal);
treeSet.add(twoDecimals);

因此，若集合表示“同一数值只能有一份”，可以在进入集合前统一 scale，或使用明确的 Comparator；若集合表示“保留原始小数位”，则不要把 TreeSet 的自然排序当成默认去重方案。对于 Map 的 key 也要做同样的语义确认，特别是缓存键、统计分组和去重导入。

相关问题

BigDecimal 比较为什么不能直接用 ==？

== 比较的是对象引用，不是 BigDecimal 的数值。业务判断使用 compareTo，表示判断使用 equals。

需要把 2.0 和 2.00 统一怎么办？

先确定领域规则：固定小数位就统一设置 scale 并选择舍入策略；只要求数值相等就用 compareTo。不要只为了让测试通过而随意去掉尾随零。