...
Eroare React · Liste, key și map

Warning: Encountered two children with the same key, `fructe`. Keys should be unique so that components maintain their identity across updates.

Pe scurt

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ă

Greșit
JSX
{produse.map((p) => (
  <li key={p.categorie}>{p.nume}</li>
))}
Corect
JSX
{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

Greșit
JSX
const toate = [...comenziOnline, ...comenziMagazin];
toate.map((c) => <li key={c.id}>{c.cod}</li>);
Corect
JSX
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ă tu

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.

Codul care dă eroarea
JSX
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?

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 key un 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

← Toate erorile React

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ță 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.