Warning: Encountered two children with the same key, `fructe`. Keys should be unique so that components maintain their identity across updates.
Două elemente din aceeași listă au primit aceeași valoare la key, deci React nu le mai poate deosebi. Folosește un câmp cu adevărat unic (id-ul), nu unul care se repetă, cum ar fi categoria sau numele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cheia trebuie să fie unică între frații din aceeași listă. Mesajul îți spune valoarea care se repetă (aici fructe), deci știi imediat ce câmp ai folosit ca key și de ce nu e bun: două produse din aceeași categorie au aceeași categorie.
Consecințele nu se văd mereu la prima randare. La actualizări, React poate dubla un rând, poate omite unul sau poate muta starea unei componente la alt element. Restul mesajului spune chiar asta: comportamentul cu chei duplicate nu este garantat și se poate schimba între versiuni.
Cauze tipice: cheie pusă pe un câmp descriptiv (categorie, oraș, nume), date din API care conțin același id de două ori, sau combinarea a două liste care își numerotează elementele de la 1.
De ce apare: cauzele frecvente
1Cheie pe un câmp care se repetă
{produse.map((p) => (
<li key={p.categorie}>{p.nume}</li>
))}{produse.map((p) => (
<li key={p.id}>{p.nume}</li>
))}Mai multe produse pot avea aceeași categorie, dar fiecare are id-ul lui.
2Două liste unite, fiecare cu id-uri de la 1
const toate = [...comenziOnline, ...comenziMagazin];
toate.map((c) => <li key={c.id}>{c.cod}</li>);const toate = [...comenziOnline, ...comenziMagazin];
toate.map((c) => <li key={c.sursa + "-" + c.id}>{c.cod}</li>);Combinând sursa cu id-ul obții o cheie unică chiar dacă id-urile se repetă între surse.
Repară eroarea, direct în pagină
Lista de mai jos folosește categoria produsului ca key, iar consola arată „Encountered two children with the same key, fructe”. Repar-o folosind o cheie unică pentru fiecare produs. Lista trebuie să afișeze în continuare toate cele trei produse.
const produse = [
{ id: 1, nume: "Mere", categorie: "fructe" },
{ id: 2, nume: "Pere", categorie: "fructe" },
{ id: 3, nume: "Morcovi", categorie: "legume" },
];
export default function App() {
return (
<ul>
{produse.map((p) => (
<li key={p.categorie}>{p.nume}</li>
))}
</ul>
);
}Indiciu
Ce câmp este diferit la fiecare produs?
Reparația
const produse = [
{ id: 1, nume: "Mere", categorie: "fructe" },
{ id: 2, nume: "Pere", categorie: "fructe" },
{ id: 3, nume: "Morcovi", categorie: "legume" },
];
export default function App() {
return (
<ul>
{produse.map((p) => (
<li key={p.id}>{p.nume}</li>
))}
</ul>
);
}De ce merge
„Mere” și „Pere” au ambele categoria fructe, deci cu key={p.categorie} două elemente au aceeași cheie. React folosește cheia ca să le identifice, iar două elemente cu aceeași identitate nu pot fi deosebite la actualizări.
p.id este diferit la fiecare produs, iar cheia rămâne legată de același produs chiar dacă lista se sortează sau se filtrează. Regula: cheia vine dintr-un câmp care identifică elementul, nu dintr-unul care îl descrie.
Alte forme ale mesajului
Warning: Encountered two children with the same key, `1`. Keys should be unique so that components maintain their identity across updates. Non-unique keys may cause children to be duplicated and/or omitted — the behavior is unsupported and could change in a future version.Encountered two children with the same key, `[object Object]`.
Cum o eviți pe viitor
- Folosește ca
keyun identificator, nu o descriere: id, cod unic, email. - Când unești date din mai multe surse, prefixează cheia cu sursa.
- Dacă datele din API au id-uri duplicate, e o problemă de date: curăță-le sau raportează-le, nu le ascunde cu
Math.random().
Întrebări frecvente
E periculos sau doar un avertisment?
Aplicația nu se oprește, dar rezultatul nu e sigur: la ștergeri sau reordonări pot apărea rânduri dublate sau lipsă. Tratează-l ca pe un bug.
Pot rezolva cu key={Math.random()}?
Avertismentul dispare, dar fiecare randare produce chei noi, deci React distruge și recreează toate rândurile la fiecare actualizare. Pierzi starea inputurilor și performanța.
Erori înrudite
Warning: Each child in a list should have a unique "key" prop. Elementele create cu map nu au prop-ul key, iar React nu le poate urmări între randări. Dă fiecărui element din listă o cheie stabilă și unică, de obicei id-ul din date: <li key={p.id}>. Warning: Rand: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. Componenta încearcă să citească props.key, dar key este rezervat pentru React și nu ajunge niciodată în props. Trimite valoarea printr-un prop separat, de exemplu id={p.id} sau cod={p.cod}. TypeError: produse.map is not a function Variabila pe care apelezi map există, dar nu este un tablou: de obicei e obiectul întreg primit de la API ({ produse: [...] }) sau un string. Pune în state tabloul din interiorul răspunsului, de exemplu data.produse. Î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.
