CORS: brak Access-Control-Allow-Origin — jak naprawić fetch?
Poradnik techniczny · Kacper Bernecki
Błąd CORS oznacza, że przeglądarka nie pozwoliła skryptowi odczytać odpowiedzi API z innego origin. Najczęściej naprawę wykonuje się na serwerze API, a nie przez obejścia po stronie frontendu.
1. Znajdź dokładne żądanie
W DevTools otwórz Network, odtwórz błąd i znajdź żądanie fetch. Zapisz adres frontendowy (Origin), URL API, metodę oraz status. Zajrzyj do Console: samo Failed to fetch nie mówi, który nagłówek jest brakujący.
Sprawdź, czy przed właściwym zapytaniem pojawia się OPTIONS. To preflight, w którym przeglądarka pyta API o dozwolone metody i nagłówki. Nieobsługiwany OPTIONS może blokować prawidłowe POST.
2. Popraw politykę API
Jeśli kontrolujesz API, ustaw Access-Control-Allow-Origin na konkretny zaufany origin i poprawnie obsłuż metody oraz żądanie OPTIONS. Przy ciasteczkach i credentials nie stosuj gwiazdki jako dozwolonego origin. Gdy odpowiedź zależy od Origin, użyj też Vary: Origin.
Dopilnuj, by nagłówki CORS były obecne także w odpowiedziach z błędami, jeśli przeglądarka ma je odczytywać. API może zwracać 401 czy 500 i równocześnie mieć źle ustawioną politykę CORS.
3. Czego nie robić
Nie wyłączaj zabezpieczeń przeglądarki i nie korzystaj z nieznanych publicznych proxy do przesyłania danych klientów. mode no-cors nie rozwiązuje potrzeby odczytania odpowiedzi: zwraca odpowiedź nieprzezroczystą.
Jeśli zewnętrzne API nie umożliwia wywołań z Twojego origin, zweryfikuj jego oficjalny backend SDK lub pośredniczący endpoint serwera, z uwzględnieniem uwierzytelnienia i limitowania żądań.