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.