React Error Boundary nie łapie odrzuconego Promise w kliknięciu
Poradnik techniczny · Kacper Bernecki
Po błędzie podczas zapisu formularza Error Boundary nie wyświetla fallbacku, a konsola pokazuje unhandled rejection. Granica błędów React dotyczy renderowania i wybranych faz komponentów, nie wszystkich błędów z handlerów czy zadań async.
Jak rozpoznać źródło problemu
Sprawdź, w którym miejscu powstaje błąd: render, event handler, useEffect czy Promise w API. Porównaj zachowanie po celowym throw w renderze z błędem odrzuconego fetch wewnątrz onClick.
Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.
Kroki naprawcze
W obsłudze zdarzenia zastosuj try/catch, kontrolowany stan błędu i czytelny komunikat użytkownika. Użyj Error Boundary dla awarii renderowania, a błędy transportowe i walidacyjne obsługuj w warstwie formularza.
Jak przetestować rozwiązanie
Błąd API pokazuje komunikat w formularzu, a błąd renderowania osobny fallback, bez białego ekranu.
Bezpieczeństwo i ograniczenia
Nie zakładaj, że jeden Error Boundary zastępuje obsługę wszystkich asynchronicznych wyjątków.