Kategoria: Next.js, React i TypeScript

Next.js API endpoint zwraca 405 dla metody OPTIONS

Poradnik techniczny · Kacper Bernecki

Aplikacja próbuje wysłać request z innej domeny, ale endpoint odpowiada Method Not Allowed podczas preflight. Trasa może nie udostępniać oczekiwanych metod lub odpowiedź OPTIONS nie zawiera wymaganych nagłówków CORS.

Jak rozpoznać źródło problemu

Sprawdź żądanie OPTIONS w DevTools oraz listę eksportowanych handlerów GET/POST/OPTIONS w pliku route.ts. Porównaj wymagane metody, nagłówki i origin z konfiguracją endpointu i reverse proxy.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Zaimplementuj OPTIONS z odpowiednimi nagłówkami Access-Control-Allow-* dla dokładnie dozwolonych domen. Zachowaj autoryzację rzeczywistego POST oraz zwracaj kontrolowane 405 dla metod celowo niewspieranych.

Jak przetestować rozwiązanie

Preflight przechodzi, a zaufany origin może wysłać właściwy POST, przy zachowaniu odmowy dla nieuprawnionych klientów.

Bezpieczeństwo i ograniczenia

Nie myl CORS z autoryzacją użytkownika; sama zgodna domena nie daje dostępu do danych.