Six Common Mistakes When Using Java BigDecimal and How to Avoid Them

In everyday Java development many developers use BigDecimal for exact calculations like money, fractions, or ratios, but improper usage can cause surprising precision loss.

Mistake 1: Directly initializing with a floating‑point literal. For example:

BigDecimal num = new BigDecimal(0.1);
System.out.println(num);

This prints a long binary‑derived value because the double literal is not exact. The correct approach is to pass a String or use BigDecimal.valueOf :

BigDecimal num = new BigDecimal("0.1");
System.out.println(num);

Mistake 2: Performing division without specifying scale. Code like:

BigDecimal c = new BigDecimal("10");
BigDecimal d = new BigDecimal("3");
BigDecimal result = c.divide(d);

throws java.lang.ArithmeticException: Non-terminating decimal expansion because the result is a repeating decimal. Fix it by providing a scale and rounding mode:

BigDecimal result = c.divide(d, 2, RoundingMode.HALF_UP);
System.out.println(result);

Mistake 3: Using equals to compare values. equals checks both value and scale, so:

BigDecimal x = new BigDecimal("1.0");
BigDecimal y = new BigDecimal("1.00");
System.out.println(x.equals(y));

prints false . Use compareTo instead:

System.out.println(x.compareTo(y) == 0);

Mistake 4: Misunderstanding scale and precision . Calling num.scale() on "123.4500" returns 4, but after stripTrailingZeros() the scale changes to 2. To fix a fixed number of decimal places, use setScale :

BigDecimal fixed = num.setScale(2, RoundingMode.HALF_UP);
System.out.println(fixed);

Mistake 5: Ignoring BigDecimal 's immutability. The method add returns a new instance; doing sum.add(new BigDecimal("1")); inside a loop leaves sum unchanged. Capture the returned value:

sum = sum.add(new BigDecimal("1"));

Mistake 6: Overlooking performance costs. BigDecimal is precise but slower; massive calculations can become a bottleneck. When possible, use integer arithmetic (e.g., cents instead of yuan) or perform bulk calculations with double and convert the final result:

double principal = 10000;
double rate = 0.05;
BigDecimal interest = BigDecimal.valueOf(principal * rate);
System.out.println(interest);

In summary, BigDecimal is a powerful numeric tool, but developers must respect its construction rules, scale handling, comparison semantics, immutability, and performance characteristics to avoid subtle bugs and inefficiencies.