Warning: Maximum update depth exceeded. This can happen when a component calls setState inside useEffect, but useEffect either doesn't have a dependency array, or one of the dependencies changes on every render.
Un useEffect setează state la fiecare randare, iar fiecare setare pornește o randare nouă: efectul n-are listă de dependențe sau depinde de ceva recreat la fiecare randare. Pune dependențele corecte sau calculează valoarea fără efect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul descrie exact bucla: o componentă apelează setState în useEffect, efectul rulează după fiecare randare, setarea produce o randare nouă, după care efectul rulează din nou. React oprește lanțul după un număr mare de actualizări și te avertizează.
Mesajul numește și cele două variante: efectul nu are listă de dependențe (useEffect(() => {...}) rulează după fiecare randare) sau o dependență se schimbă la fiecare randare, de exemplu un obiect, un tablou sau o funcție create în corpul componentei. [filtre], unde filtre = { categorie: "carti" } este creat la fiecare randare, este o dependență nouă de fiecare dată.
Adesea efectul nici nu e necesar: dacă doar calculezi o valoare din props sau state (o listă filtrată, un total), calculeaz-o direct la randare.
De ce apare: cauzele frecvente
1Efect fără listă de dependențe care setează state
const [filtrate, setFiltrate] = useState([]);
useEffect(() => {
setFiltrate(produse.filter((p) => p.stoc > 0));
});const filtrate = produse.filter((p) => p.stoc > 0);Lista filtrată se poate calcula din produse, deci nu are nevoie de state și nici de efect.
2Dependență recreată la fiecare randare
const optiuni = { categorie: "carti" };
useEffect(() => {
setRezultate(cauta(optiuni));
}, [optiuni]);const categorie = "carti";
useEffect(() => {
setRezultate(cauta({ categorie }));
}, [categorie]);Un string este comparat după valoare; un obiect nou are mereu altă referință, deci efectul rulează la nesfârșit.
3Efect care modifică propria dependență
useEffect(() => {
setVizite(vizite + 1);
}, [vizite]);useEffect(() => {
setVizite((v) => v + 1);
}, []);Efectul care schimbă vizite și depinde de vizite se reapelează singur; rulat o dată, la montare, nu mai creează bucla.
Repară eroarea, direct în pagină
Componenta de mai jos afișează produsele aflate în stoc, dar efectul ei setează state la fiecare randare, iar consola se umple de „Maximum update depth exceeded”. Repar-o ca lista să afișeze cele două produse în stoc (câte un li), fără bucla de actualizări.
import { useState, useEffect } from "react";
const produse = [
{ id: 1, nume: "Lampă", stoc: 3 },
{ id: 2, nume: "Covor", stoc: 0 },
{ id: 3, nume: "Pernă", stoc: 8 },
];
export default function App() {
const [inStoc, setInStoc] = useState([]);
useEffect(() => {
setInStoc(produse.filter((p) => p.stoc > 0));
});
return (
<ul>
{inStoc.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}Indiciu
Lista filtrată se poate calcula direct din produse.
Reparația
const produse = [
{ id: 1, nume: "Lampă", stoc: 3 },
{ id: 2, nume: "Covor", stoc: 0 },
{ id: 3, nume: "Pernă", stoc: 8 },
];
export default function App() {
const inStoc = produse.filter((p) => p.stoc > 0);
return (
<ul>
{inStoc.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}De ce merge
Fără listă de dependențe, efectul rulează după fiecare randare. Fiecare rulare apelează setInStoc cu un tablou nou (filter creează mereu un tablou nou), React vede o valoare diferită și randează din nou, iar efectul rulează iar. React oprește lanțul și te avertizează.
Lista produselor în stoc depinde doar de produse, deci se poate calcula direct la randare. Fără state și fără efect nu mai există nicio actualizare care să pornească bucla, iar codul e și mai scurt.
Alte forme ale mesajului
Error: Maximum update depth exceeded. This can happen when a component repeatedly calls setState inside componentWillUpdate or componentDidUpdate. React limits the number of nested updates to prevent infinite loops.Uncaught Error: Maximum update depth exceeded.
Cum o eviți pe viitor
- Înainte să scrii un
useEffectcare doar setează state, întreabă-te dacă valoarea nu se poate calcula direct la randare. - Pune mereu lista de dependențe și include în ea doar valori primitive sau stabile.
- Obiectele și funcțiile folosite ca dependențe mută-le în interiorul efectului sau stabilizează-le cu
useMemo/useCallback.
Întrebări frecvente
Care e diferența față de „Too many re-renders”?
„Too many re-renders” apare când setezi state chiar în timpul randării. „Maximum update depth exceeded” apare când actualizările se înlănțuie prin efecte sau prin metode de ciclu de viață (componentDidUpdate).
Pagina pare să funcționeze, doar consola se umple. E grav?
Da: componenta se randează de sute de ori, procesorul lucrează continuu, iar orice cerere fetch din efect se trimite la fel de des. Repară bucla.
Erori înrudite
Too many re-renders. React limits the number of renders to prevent an infinite loop. Componenta schimbă state-ul chiar în timpul randării, de obicei prin onClick={setDeschis(true)}, care apelează funcția imediat. Dă evenimentului o funcție: onClick={() => setDeschis(true)}. React Hook useEffect has a missing dependency: 'id'. Either include it or remove the dependency array. Efectul folosește o valoare (prop sau state) care lipsește din lista de dependențe, deci nu rulează din nou când ea se schimbă. Adaug-o în listă: useEffect(() => {...}, [id]). Warning: Cannot update a component (`App`) while rendering a different component (`Cos`). To locate the bad setState() call inside `Cos`, follow the stack trace as described in https://reactjs.org/link/setstate-in-render O componentă copil apelează, în timpul randării, un setter primit de la părinte. Randarea trebuie să fie fără efecte: calculează valoarea direct în părinte sau mută apelul într-un handler ori într-un useEffect. Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
