błąd 405 Method Not Allowed

Błąd 405 Method Not Allowed oznacza, że serwer nie obsługuje danej metody żądania dla wskazanego zasobu.

Co oznacza odpowiedź HTTP 405

Błąd „405 Method Not Allowed” jest odpowiedzią protokołu HTTP informującą, że serwer rozpoznał metodę żądania, ale nie zezwala na jej użycie dla wskazanego zasobu. Metodą jest między innymi GET, POST, PUT, PATCH, DELETE, HEAD lub OPTIONS, natomiast zasobem może być strona internetowa, endpoint API, plik albo adres obsługiwany przez aplikację. Przykładowo serwer może poprawnie udostępniać adres /kontakt przy użyciu GET, lecz odrzucać wysłanie żądania POST pod ten sam adres.

W standardowym przebiegu serwer zwracający kod 405 powinien przekazać w nagłówku Allow listę metod dozwolonych dla danego zasobu, na przykład Allow: GET, HEAD. Nie oznacza to jednak, że każda konfiguracja wyświetli ten nagłówek prawidłowo. Treść strony błędu może pochodzić z serwera WWW, odwrotnego proxy, frameworka aplikacyjnego albo systemu zarządzania treścią, dlatego sam komunikat widoczny w przeglądarce nie zawsze wskazuje miejsce wystąpienia problemu.

Różnica między metodą żądania a adresem zasobu

Najczęstsza przyczyna błędu 405 polega na pomyleniu adresu z operacją, którą można pod tym adresem wykonać. Przeglądarka podczas otwierania strony zazwyczaj wysyła GET. Formularz może natomiast wysyłać POST, a skrypt JavaScript może korzystać z PUT, PATCH lub DELETE. Jeżeli trasa aplikacji została zdefiniowana wyłącznie dla GET, wysłanie POST zakończy się kodem 405, nawet gdy adres istnieje i połączenie z serwerem działa poprawnie.

405 różni się od kilku podobnych odpowiedzi. Kod 404 oznacza, że serwer nie znalazł wskazanego zasobu albo celowo nie ujawnia jego istnienia. Kod 403 wskazuje na odmowę dostępu wynikającą z uprawnień lub reguł bezpieczeństwa, a niekoniecznie z niedozwolonej metody. Kod 501 oznacza brak implementacji danej funkcji przez serwer. Przy 405 metoda jest znana, lecz niepasująca do konkretnego zasobu. Z kolei kod 400 zwykle wskazuje nieprawidłowo zbudowane żądanie, a nie sam wybór metody.

Gdzie szukać przyczyny w konfiguracji i aplikacji

Diagnostykę warto rozpocząć od sprawdzenia rzeczywistej metody, adresu URL i odpowiedzi serwera. W narzędziach deweloperskich przeglądarki, w zakładce Network, można zobaczyć metodę żądania, kod odpowiedzi, przekierowania oraz nagłówki. Przydatne jest również polecenie curl -i -X POST https://example.com/adres, ale należy używać go wyłącznie dla adresu, którego testowanie jest dozwolone. Opcja -i pokazuje nagłówki, w tym ewentualny nagłówek Allow. Zwykłe sprawdzenie strony poleceniem curl -i https://example.com/adres pozwala porównać zachowanie GET z metodą zgłaszaną przez aplikację.

Jeżeli problem dotyczy własnej strony, trzeba porównać definicję trasy w aplikacji z formularzem lub kodem klienta. Błąd może wynikać z ustawienia formularza method="post" przy trasie obsługującej tylko GET, z nieprawidłowego endpointu API, z reguł serwera Apache albo Nginx, z konfiguracji proxy lub z przekazania żądania do niewłaściwego backendu. Osobną sytuacją jest żądanie OPTIONS wysyłane przed właściwym żądaniem przez mechanizm CORS. Jeśli serwer nie obsługuje poprawnie tej metody lub nie zwraca wymaganych nagłówków, aplikacja przeglądarkowa może zgłosić problem jeszcze przed wysłaniem właściwego żądania.

Usuwanie błędu na laptopie lub komputerze PC

Na komputerze użytkownika warto najpierw ustalić, czy błąd występuje tylko w jednej przeglądarce, tylko na jednym urządzeniu, czy u wszystkich osób korzystających z serwisu. Można sprawdzić adres wpisany ręcznie, otworzyć stronę w trybie prywatnym, wyłączyć rozszerzenia modyfikujące żądania oraz zweryfikować, czy zapisany zakładką URL nie prowadzi do starego endpointu. Jeżeli błąd pojawia się podczas korzystania z programu, należy sprawdzić jego konfigurację adresu API, sposób wysyłania formularza i aktualność wersji aplikacji. Samo czyszczenie pamięci podręcznej nie zmieni reguł metod po stronie serwera, ale może wyeliminować korzystanie ze starego kodu JavaScript po wdrożeniu poprawki.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i podzespołów, a przy zgłoszeniu związanym z błędem 405 może pomóc rozdzielić problem lokalny od usterki strony lub aplikacji. W praktyce serwisant sprawdza połączenie sieciowe, działanie przeglądarki, rozszerzenia, konfigurację programu oraz powtarzalność błędu na innym urządzeniu. Jeżeli identyczna odpowiedź 405 występuje na różnych komputerach i przy tym samym adresie, bardziej prawdopodobna jest niezgodność metody z konfiguracją serwera albo błąd aplikacji po stronie operatora witryny. Taka informacja pozwala skierować zgłoszenie do właściwego administratora z dokładnym adresem, metodą żądania, czasem wystąpienia i kodem odpowiedzi.