Kategoria: Next.js, React i TypeScript

React: Encountered two children with the same key w liście rekordów

Poradnik techniczny · Kacper Bernecki

Po aktualizacji lub filtrowaniu elementy listy mylą się, a konsola ostrzega o identycznych kluczach. React używa key do zachowania tożsamości elementów; dwa rekordy o takim samym kluczu zrywają to dopasowanie.

Jak ustalić źródło błędu

Porównaj identyfikatory zwrócone z API oraz wartości używane jako key przy mapowaniu listy.

Sprawdź, czy ta sama pozycja nie jest dokładana dwa razy wskutek paginacji lub nieidempotentnego fetch.

Co zrobić krok po kroku

1. Wybierz stabilny unikalny identyfikator z danych, a gdy go brakuje, napraw model danych lub usuń faktyczny duplikat.

2. Przy stronicowaniu łącz wyniki po ID, nie przez ślepe doklejanie wszystkich odpowiedzi.

Jak sprawdzić wynik

Po filtrowaniu, sortowaniu i aktualizacji każdy element zachowuje właściwą tożsamość i stan.

Czego nie robić

Nie używaj Math.random() ani indeksu tablicy do dynamicznej listy, która zmienia kolejność.