Почему BigDecimal.equals может странно работать даже при одинаковом числе?

BigDecimal часто используют для денег, процентов и точных расчётов. Но сравнивать такие значения через equals не всегда то, что ожидается.

Посмотри на пример:

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

System.out.println(a.equals(b));

Математически это одно и то же значение. Но equals вернёт false, потому что BigDecimal сравнивает не только число, но и scale.

У этих объектов разный scale:

System.out.println(a.scale()); // 1
System.out.println(b.scale()); // 2

Для денежных расчётов это может быть неожиданно. Например, значение из базы пришло как 1.00, а значение из расчёта получилось как 1.0.

Если нужно сравнить именно числовое значение, используй compareTo:

if (a.compareTo(b) == 0) {
    System.out.println("same value");
}

compareTo смотрит на математическое значение и не считает scale причиной различия.

А вот в коллекциях equals всё равно важен:

Set<BigDecimal> values = new HashSet<>();
values.add(new BigDecimal("1.0"));
values.add(new BigDecimal("1.00"));

В таком Set будет два элемента, потому что HashSet опирается на equals и hashCode.

Если тебе нужен единый формат, значение можно нормализовать:

var normalized = amount.stripTrailingZeros();

Но для денег нормализацию лучше делать осознанно, чтобы не потерять важный формат отображения.

Для числового сравнения BigDecimal используй compareTo, а equals оставляй для случаев, где важен ещё и scale.

👉 Java Ready | #совет