StackOverflowError Java Origin: Application & API Last updated 13 Oct 2026

java.lang.StackOverflowError

The thread’s call stack overflowed — almost always unbounded recursion, sometimes a bidirectional toString/equals/JSON cycle.

Explore the map of this error Full error map →
Seen on: Java Android

Meaning

The stack trace repeats the same few frames. Common non-obvious sources: JPA entities with bidirectional relations in toString()/hashCode() (Lombok @Data), Jackson serialising cycles, and Spring beans calling each other.

Common causes

  • Recursion without a terminating condition
  • Lombok @Data / toString on bidirectional JPA relations
  • Jackson serialising parent ↔ child references
  • Very deep (legitimate) recursion on large inputs

⚡ Quick fix

  1. Find the repeating frames in the trace
  2. Exclude back-references from toString/equals (@ToString.Exclude)
  3. Use @JsonManagedReference/@JsonBackReference or DTOs
  4. Convert deep recursion to iteration, or raise -Xss as a last resort

Detailed fix by platform

Java

  1. Break JPA/Lombok cycles:
    java
    @Entity @Getter @Setter
public class Order {
    @ManyToOne
    @ToString.Exclude @EqualsAndHashCode.Exclude
    @JsonBackReference
    private Customer customer;
}

How to diagnose

  1. Frames — Which methods repeat?
  2. Entities — toString/equals/JSON cycles?
  3. Input size — Legitimately deep recursion?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

JsonException object cycle — JsonException: A possible object cycle was detected (.NET)JsonException object …Maximum function nesting — Fatal error: Maximum function nesting level of '256' reached, aborting! (PHP)Maximum function nest…OutOfMemoryError — java.lang.OutOfMemoryError: Java heap space (Java)OutOfMemoryErrorRangeError — RangeError: Maximum call stack size exceeded (JavaScript)RangeErrorrecursion limit — Msg 530: The statement terminated. The maximum recursion 100 has been exhausted before statement completion. / MySQL 3636 Recursive query aborted after 1001 iterations (SQL)recursion limitRecursionError — RecursionError: maximum recursion depth exceeded (Python)RecursionErrorStack overflow — .NET: Stack overflow. / Process is terminated due to StackOverflowException (.NET)Stack overflowStackOver…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.