...
Eroare Spring Boot · JSON și Jackson

Could not write JSON: Infinite recursion (StackOverflowError)

Pe scurt

Jackson a intrat într-o buclă: entitatea Categorie are lista de produse, fiecare produs trimite înapoi la categorie și tot așa, până se umple stiva. Întoarce un DTO din controller sau oprește una dintre direcții cu @JsonIgnore (ori @JsonManagedReference / @JsonBackReference).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când un controller întoarce un obiect, Jackson îl transformă în JSON citind toate getter-ele. La o relație bidirecțională (Categorie.getProduse() și Produs.getCategorie()), Jackson scrie categoria, apoi produsele ei, apoi categoria fiecărui produs, apoi din nou produsele, la nesfârșit. Stiva de apeluri se umple, apare StackOverflowError, iar Jackson o raportează ca HttpMessageNotWritableException: Could not write JSON: Infinite recursion (StackOverflowError). Clientul primește 500.

În jurnal vezi de obicei și lanțul de câmpuri prin care a trecut: Categorie["produse"]->Produs["categorie"]->Categorie["produse"].... El îți arată exact care sunt cele două câmpuri care se trimit unul pe altul.

Problema nu e în baza de date, ci în faptul că expui entitățile JPA direct în API. Modelul cu relații în ambele sensuri e corect pentru JPA, dar JSON-ul are nevoie de o formă fără cicluri.

De ce apare: cauzele frecvente

1Controller-ul întoarce entitatea cu relație bidirecțională

Greșit
JAVA
@GetMapping("/categorii/{id}")
Categorie una(@PathVariable long id) {
    return repo.findById(id).orElseThrow();
}
Corect
JAVA
record ProdusDto(long id, String nume) { }
record CategorieDto(long id, String nume, List<ProdusDto> produse) { }

@GetMapping("/categorii/{id}")
CategorieDto una(@PathVariable long id) {
    Categorie c = repo.findById(id).orElseThrow();
    return new CategorieDto(c.getId(), c.getNume(),
        c.getProduse().stream().map(p -> new ProdusDto(p.getId(), p.getNume())).toList());
}

DTO-ul are doar câmpurile de care are nevoie clientul, fără drum înapoi spre categorie, deci JSON-ul nu mai are ciclu.

2Ambele direcții ale relației sunt serializate

Greșit
JAVA
@ManyToOne
private Categorie categorie;

public Categorie getCategorie() { return categorie; }
Corect
JAVA
@ManyToOne
private Categorie categorie;

@JsonIgnore
public Categorie getCategorie() { return categorie; }

@JsonIgnore scoate din JSON partea care închide cercul; relația rămâne în model și în baza de date.

3Perechea de referințe Jackson

Greșit
JAVA
@OneToMany(mappedBy = "categorie")
private List<Produs> produse;
Corect
JAVA
@JsonManagedReference
@OneToMany(mappedBy = "categorie")
private List<Produs> produse;

// în Produs
@JsonBackReference
@ManyToOne
private Categorie categorie;

Partea @JsonManagedReference se scrie normal, iar partea @JsonBackReference este omisă la scriere.

Repară tu

Repară eroarea, direct în pagină

GET /categorii/1 răspunde 500 cu Could not write JSON: Infinite recursion (StackOverflowError): categoria are produse, iar fiecare produs trimite înapoi la categorie. Oprește bucla din JSON, fără să schimbi relațiile JPA, ca răspunsul să fie categoria cu lista produselor ei (id și nume).

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.data.jpa.repository.JpaRepository;
import com.fasterxml.jackson.annotation.JsonIgnore;
import jakarta.persistence.*;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@Entity
class Categorie {
    @Id @GeneratedValue
    private Long id;
    private String nume;
    @OneToMany(mappedBy = "categorie")
    private List<Produs> produse = new ArrayList<>();

    protected Categorie() { }

    public Long getId() { return id; }
    public String getNume() { return nume; }
    public List<Produs> getProduse() { return produse; }
}

@Entity
class Produs {
    @Id @GeneratedValue
    private Long id;
    private String nume;
    @ManyToOne
    private Categorie categorie;

    protected Produs() { }

    public Long getId() { return id; }
    public String getNume() { return nume; }
    // TODO: Jackson merge din produs înapoi în categorie, la nesfârșit
    public Categorie getCategorie() { return categorie; }
}

interface CategorieRepository extends JpaRepository<Categorie, Long> { }

@RestController
class CategorieController {
    private final CategorieRepository repo;

    CategorieController(CategorieRepository repo) {
        this.repo = repo;
    }

    @GetMapping("/categorii/{id}")
    Categorie una(@PathVariable long id) {
        return repo.findById(id).orElseThrow();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /categorii/1 → 200
{"id":1,"nume":"Periferice","produse":[{"id":1,"nume":"Mouse"},{"id":2,"nume":"Tastatură"}]}
Indiciu

Pune @JsonIgnore pe getter-ul care duce din produs înapoi la categorie.

Alte forme ale mesajului

  • HttpMessageNotWritableException: Could not write JSON: Infinite recursion (StackOverflowError)
  • com.fasterxml.jackson.databind.JsonMappingException: Infinite recursion (StackOverflowError) (through reference chain: Categorie["produse"]->java.util.ArrayList[0]->Produs["categorie"]->Categorie["produse"])
  • Document nesting depth (1001) exceeds the maximum allowed (1000, from `StreamWriteConstraints.getMaxNestingDepth()`)

Cum o eviți pe viitor

  • Nu întoarce entități JPA din controllere: folosește DTO-uri (record-uri) pentru fiecare răspuns.
  • Fă relațiile bidirecționale doar când chiar ai nevoie de ambele direcții în cod.
  • Dacă totuși expui entități, marchează partea inversă cu @JsonIgnore sau @JsonBackReference.
  • Scrie un test MockMvc pentru fiecare endpoint care întoarce obiecte cu relații.

Întrebări frecvente

De ce mesajul apare doar la unele endpoint-uri?

Doar acolo unde răspunsul conține ambele capete ale unei relații. O listă de produse fără categorie se serializează fără probleme, dar o categorie cu produsele ei, care o referă înapoi, intră în buclă.

În versiunile noi Jackson văd alt mesaj. E aceeași problemă?

Da. Jackson 2.15+ poate opri bucla mai devreme cu Document nesting depth (1001) exceeds the maximum allowed. Cauza și reparația sunt aceleași: un ciclu de referințe în obiectul serializat.

@JsonIgnore pe câmp sau pe getter?

Merge pe oricare, cât timp Jackson găsește adnotarea pentru proprietatea respectivă. Important e să o pui pe o singură direcție, nu pe amândouă.

Erori înrudite

← Toate erorile Spring Boot

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.