Could not write JSON: Infinite recursion (StackOverflowError)
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ă
@GetMapping("/categorii/{id}")
Categorie una(@PathVariable long id) {
return repo.findById(id).orElseThrow();
}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
@ManyToOne
private Categorie categorie;
public Categorie getCategorie() { return categorie; }@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
@OneToMany(mappedBy = "categorie")
private List<Produs> produse;@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ă 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).
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();
}
}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.
Reparația
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; }
@JsonIgnore
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();
}
}De ce merge
Jackson citea getter-ele în cerc: categorie → produse → categorie → produse. Cu @JsonIgnore pe getCategorie(), produsul nu mai scrie categoria lui în JSON, deci lanțul se oprește după primul nivel. Relația @ManyToOne rămâne neschimbată, așa că JPA leagă în continuare produsele de categorie. Într-un proiect mai mare, varianta curată este un DTO pentru răspuns.
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
@JsonIgnoresau@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
No serializer found for class Produs and no properties discovered to create BeanSerializer (to avoid exception, disable SerializationFeature.FAIL_ON_EMPTY_BEANS) Jackson nu găsește nicio proprietate de scris în JSON pentru clasa întoarsă: câmpurile sunt private și clasa nu are getter-e publice. Adaugă getter-e (getNume()), folosește un record sau un DTO. LazyInitializationException: failed to lazily initialize a collection of role: Categorie.produse: could not initialize proxy - no Session Ai citit o relație LAZY (de obicei o colecție @OneToMany) după ce tranzacția s-a închis, de exemplu când Jackson serializează entitatea în controller. Încarcă datele de care ai nevoie în service, într-o metodă @Transactional(readOnly = true), și întoarce un DTO (sau folosește JOIN FETCH). mappedBy reference an unknown target entity property: Produs.categoria in Categorie.produse Valoarea din mappedBy trebuie să fie numele câmpului care deține relația în cealaltă entitate. Ai scris un nume care nu există acolo (categoria în loc de categorie), iar Hibernate oprește pornirea. Copiază exact numele câmpului @ManyToOne din entitatea copil. Î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.
