Błąd HTTP 505 (HTTP Version Not Supported) oznacza, że serwer odrzuca żądanie klienta, bo używa wersji protokołu HTTP, której nie obsługuje. Problem leży najczęściej w konfiguracji serwera Apache lub Nginx – rzadziej po stronie przeglądarki użytkownika. Artykuł prowadzi administratora przez diagnozę logów, korektę plików konfiguracyjnych i profilaktykę w 5 krokach.
Co to jest błąd HTTP 505 i kiedy się pojawia?
Błąd HTTP 505 to kod odpowiedzi serwera z grupy 5xx sygnalizujący, że serwer nie obsługuje wersji protokołu HTTP, w jakiej klient przesłał żądanie. W odróżnieniu od błędów grupy 4xx (np. 404), które wskazują na problem po stronie klienta, kody 5xx informują o awarii lub ograniczeniu po stronie serwera.
Mechanizm jest prosty: przeglądarka, bot indeksujący lub klient API wysyła żądanie z konkretną wersją HTTP (np. HTTP/2). Serwer sprawdza nagłówek żądania i jeśli nie rozpoznaje lub celowo odrzuca tę wersję – zwraca kod statusu HTTP 505. Specyfikacja tego kodu znajduje się w dokumencie RFC 9110 (sekcja 15.6.6), który definiuje go jako „serwer nie obsługuje lub odmawia obsługi głównej wersji protokołu HTTP użytej w żądaniu”.
Błąd HTTP 505 jest jednym z najrzadszych kodów odpowiedzi – pojawia się znacznie rzadziej niż 404 (Not Found) czy 500 (Internal Server Error). W praktyce większość serwerów obsługuje przynajmniej HTTP/1.1, więc sytuacja niezgodności wersji dotyczy głównie źle skonfigurowanych środowisk lub przestarzałego oprogramowania.
Jak wygląda komunikat błędu 505?
Komunikat błędu HTTP 505 może przybierać różne formy w zależności od serwera i konfiguracji. Najczęstsze warianty to:
- 505 HTTP Version Not Supported – standardowy komunikat zgodny z RFC
- HTTP Error 505: HTTP Version Not Supported – wariant stosowany przez serwery IIS
- The server does not support the HTTP protocol version used in the request – rozszerzona wersja komunikatu w Apache
Wygląd strony błędu zależy od konfiguracji serwera. Apache wyświetla domyślną stronę HTML z białym tłem, Nginx zwraca minimalistyczny komunikat tekstowy, a serwery z niestandardowymi stronami błędów (np. w WordPress) mogą pokazywać własny szablon.
Czym różni się błąd 505 od błędów 500 i 502?
Trzy najczęściej mylone kody z grupy 5xx mają fundamentalnie różne przyczyny. Poniższa tabela porównawcza pomaga szybko ustalić, z którym problemem mamy do czynienia.
| Cecha | 505 (HTTP Version Not Supported) | 500 (Internal Server Error) | 502 (Bad Gateway) |
|---|---|---|---|
| Przyczyna | Niezgodność wersji protokołu HTTP | Wewnętrzny błąd skryptu lub konfiguracji serwera | Błędna odpowiedź z serwera upstream |
| Gdzie szukać | Konfiguracja wersji HTTP (httpd.conf, nginx.conf) | Logi aplikacji, uprawnienia plików, limity pamięci | Serwer proxy, load balancer, backend |
| Kto odpowiada | Serwer (konfiguracja) lub klient (stara przeglądarka) | Serwer (kod aplikacji lub konfiguracja) | Infrastruktura pośrednicząca (proxy, CDN) |
| Częstość | Bardzo rzadki | Najczęstszy błąd 5xx | Częsty przy architekturze z proxy |
Przyczyny błędu HTTP 505 – serwer czy klient?
Błąd HTTP 505 najczęściej wynika z konfiguracji serwera (Apache, Nginx) lub infrastruktury pośredniczącej – serwera proxy lub load balancera – i rzadko jest winą samego użytkownika. Ta cecha odróżnia kod 505 od większości błędów 5xx, ponieważ odpowiedzialność może leżeć po obu stronach komunikacji.
Prosta reguła diagnostyczna: jeśli błąd HTTP 505 pojawia się we wszystkich przeglądarkach i na wszystkich urządzeniach, problem leży po stronie serwera. Jeśli błąd występuje tylko w jednej przeglądarce lub na jednym urządzeniu – przyczyna jest lokalna.
Nieobsługiwana wersja protokołu HTTP (HTTP/1.0, HTTP/1.1, HTTP/2, HTTP/3)
Najczęstsza przyczyna błędu 505 to niezgodność między wersją protokołu HTTP żądaną przez klienta a wersją obsługiwaną przez serwer. Poniższa tabela przedstawia różnice między wersjami.
| Wersja | Rok publikacji | Charakterystyka | Status wsparcia |
|---|---|---|---|
| HTTP/1.0 | 1996 | Jedno połączenie na żądanie, brak persistent connections | Przestarzała, rzadko wymagana |
| HTTP/1.1 | 1997 | Persistent connections, chunked transfer, host header | Standard – obsługiwana przez 100% serwerów |
| HTTP/2 | 2015 | Multipleksowanie, kompresja nagłówków, wymaga SSL/TLS | Obsługiwana przez ponad 97% przeglądarek |
| HTTP/3 | 2022 | Oparty na QUIC (UDP), niższe opóźnienia | We wdrażaniu – ok. 30% serwerów globalnie |
Typowy scenariusz: klient wysyła żądanie w HTTP/2, ale serwer obsługuje wyłącznie HTTP/1.1 i nie potrafi automatycznie obniżyć wersji protokołu. Rezultat – błąd 505.
Błędna konfiguracja serwera lub proxy
Brakujące lub nieprawidłowe dyrektywy w plikach konfiguracyjnych to druga najczęstsza przyczyna błędu HTTP 505. W Apache problem może wynikać z wyłączonego modułu http2 lub braku dyrektywy Protocols w bloku VirtualHost. W Nginx przyczyną jest brak parametru http2 w dyrektywie listen.
Serwer proxy (np. Squid) lub load balancer mogą modyfikować nagłówki HTTP w sposób, który wprowadza niezgodność wersji. Proxy przekazujący żądanie HTTP/2 do backendu obsługującego tylko HTTP/1.1 – bez automatycznej negocjacji – wygeneruje błąd 505.
Przestarzałe oprogramowanie serwera lub przeglądarki
Starsze wersje Apache (poniżej 2.4.17) nie obsługują HTTP/2. Podobnie Nginx w wersjach wcześniejszych niż 1.9.5 nie wspiera tego protokołu. Serwer z nieaktualizowanym oprogramowaniem odrzuci żądania klientów używających nowszych wersji HTTP.
Po stronie klienta problem jest rzadszy – ponad 97% współczesnych przeglądarek automatycznie się aktualizuje. Stare przeglądarki (np. Internet Explorer 11) mogą jednak wysyłać żądania w formacie nieakceptowanym przez nowoczesne serwery.
Błędnie sformułowany request-line – niedoceniana przyczyna
Rzadką, ale realną przyczyną błędu HTTP 505 jest nieprawidłowy request-line w żądaniu HTTP. Dokumentacja MDN Web Docs opisuje ten edge case: gdy URL zawiera nieodkodowane spacje, serwer może błędnie zinterpretować fragment ścieżki jako wersję protokołu.
Przykład błędnego żądania:
GET /dog trainers HTTP/1.1
Serwer odczytuje trainers jako wersję HTTP zamiast części ścieżki URL. Poprawna wersja powinna używać percent-encoding (%20 zamiast spacji):
GET /dog%20trainers HTTP/1.1
Ten problem pojawia się przy błędnej konfiguracji load balancera lub aplikacji generującej URL-e bez prawidłowego kodowania znaków specjalnych.
Jak zdiagnozować błąd 505? Logi, curl i DevTools
Diagnostykę błędu HTTP 505 należy zacząć od analizy logów serwera (error.log), a następnie potwierdzić niezgodność wersji protokołu komendami curl z różnymi flagami HTTP. Trójstopniowa procedura – logi, curl, DevTools – pozwala zlokalizować przyczynę w ciągu kilku minut.
Analiza logów serwera Apache i Nginx
Logi serwera to pierwsza linia diagnostyki błędu HTTP 505. Poniższe komendy wyświetlają ostatnie 100 wpisów z logów błędów:
# Apache:
sudo tail -n 100 /var/log/apache2/error.log
# Nginx:
sudo tail -n 100 /var/log/nginx/error.log
W logach szukaj fraz: HTTP Version Not Supported, Unsupported HTTP version, HTTP protocol error. Data i godzina wpisu pozwalają skorelować błąd z konkretnym żądaniem. Dodatkowe informacje o adresie IP klienta pomagają ustalić, czy problem dotyczy jednego użytkownika czy wszystkich.
Testowanie wersji HTTP komendami curl
Komendy curl pozwalają precyzyjnie przetestować, którą wersję protokołu HTTP serwer obsługuje. To najszybsza metoda potwierdzenia przyczyny błędu 505:
# Test z HTTP/1.0:
curl -v --http1.0 https://twojadomena.pl/
# Test z HTTP/1.1:
curl -v --http1.1 https://twojadomena.pl/
# Test z HTTP/2:
curl -v --http2 https://twojadomena.pl/
Flaga -v (verbose) wyświetla pełne nagłówki odpowiedzi. Jeśli serwer zwraca kod 505 przy konkretnej wersji (np. --http2), a przy innej (np. --http1.1) działa poprawnie – przyczyna jest zlokalizowana. Wynik < HTTP/2 200 oznacza prawidłową obsługę HTTP/2.
Narzędzia deweloperskie przeglądarki (DevTools)
DevTools w Chrome i Firefox umożliwiają szybką diagnozę błędu HTTP 505 bez dostępu do serwera. Otwórz narzędzia deweloperskie skrótem F12 lub Ctrl+Shift+I, przejdź do zakładki Network i odśwież stronę.
W kolumnie Status zobaczysz kod odpowiedzi 505. Kliknięcie na żądanie pokazuje szczegóły nagłówków – w tym wersję protokołu HTTP użytą w żądaniu i odpowiedzi. DevTools są przydatne, gdy nie masz dostępu SSH do serwera i potrzebujesz szybkiej weryfikacji problemu.
Jak naprawić błąd 505 po stronie serwera?
Naprawa błędu HTTP 505 po stronie serwera polega na włączeniu obsługi HTTP/2 i dodaniu dyrektywy Protocols h2 http/1.1 w Apache lub listen 443 ssl http2 w Nginx – a następnie restarcie usługi. Przed wprowadzeniem jakichkolwiek zmian wykonaj kopię zapasową plików konfiguracyjnych.
Konfiguracja Apache – dyrektywa Protocols i moduł HTTP/2
Naprawa błędu 505 w Apache wymaga trzech kroków. Najpierw włącz moduł http2:
Krok 1 – aktywacja modułu:
sudo a2enmod http2
Krok 2 – edycja pliku VirtualHost (port 443 z SSL):
<VirtualHost *:443>
Protocols h2 http/1.1
ServerName twojadomena.pl
SSLEngine on
SSLCertificateFile /etc/ssl/certs/twojadomena.pem
SSLCertificateKeyFile /etc/ssl/private/twojadomena.key
# pozostałe ustawienia...
</VirtualHost>
Dyrektywa Protocols h2 http/1.1 nakazuje Apache obsługiwać zarówno HTTP/2, jak i HTTP/1.1, zapewniając kompatybilność wstecz.
Krok 3 – restart serwera i weryfikacja:
sudo systemctl restart apache2
curl -v --http2 https://twojadomena.pl/
Plik konfiguracyjny znajduje się zazwyczaj w /etc/apache2/sites-available/ (Debian/Ubuntu) lub /etc/httpd/conf.d/ (CentOS/RHEL).
Konfiguracja Nginx – dyrektywa listen http2
W Nginx włączenie obsługi HTTP/2 wymaga modyfikacji bloku server dla portu 443:
Krok 1 – edycja pliku nginx.conf lub pliku serwera wirtualnego:
server {
listen 443 ssl http2;
server_name twojadomena.pl;
ssl_certificate /etc/ssl/certs/twojadomena.pem;
ssl_certificate_key /etc/ssl/private/twojadomena.key;
# pozostałe ustawienia...
}
Opcjonalnie dostosuj parametry HTTP/2 w sekcji http:
http {
http2_max_field_size 16k;
http2_max_header_size 32k;
}
Krok 2 – sprawdzenie poprawności konfiguracji i restart:
sudo nginx -t
sudo systemctl restart nginx
Komenda nginx -t weryfikuje składnię przed restartem, co zapobiega wyłączeniu serwera z powodu literówki w konfiguracji.
Naprawa po stronie serwera proxy i load balancera
Jeśli błąd HTTP 505 występuje pomimo prawidłowej konfiguracji Apache lub Nginx, problem może leżeć w infrastrukturze pośredniczącej. Load balancer lub serwer proxy (np. Squid, HAProxy) może modyfikować nagłówki HTTP, wprowadzając niezgodność wersji protokołu.
Sprawdź, czy proxy nie wymusza konkretnej wersji HTTP. W konfiguracji Squid upewnij się, że parametr http_port obsługuje wymagane wersje. W HAProxy zweryfikuj sekcję defaults – parametr option http-use-htx włącza nowy parser HTTP wspierający HTTP/2. Testuj połączenie bezpośrednio do backendu (z pominięciem proxy), aby wykluczyć lub potwierdzić tę przyczynę.
Jak naprawić błąd 505 po stronie użytkownika?
Jeśli błąd HTTP 505 pojawia się tylko w jednej przeglądarce lub na jednym urządzeniu, użytkownik może spróbować kilku kroków naprawczych bez konieczności kontaktu z administratorem. Poniższa lista zaczyna się od najprostszych działań.
- Sprawdź poprawność adresu URL – usuń zbędne spacje, literówki i znaki specjalne z paska adresu
- Wyczyść pamięć podręczną i pliki cookie – użyj skrótu Ctrl+Shift+Delete i zaznacz opcje cache oraz cookies
- Wymuś pełne odświeżenie strony – naciśnij Ctrl+F5 (Windows) lub Cmd+Shift+R (macOS)
- Wyłącz rozszerzenia przeglądarki – niektóre wtyczki (VPN, ad-blockery, narzędzia deweloperskie) mogą modyfikować nagłówki HTTP
- Zaktualizuj przeglądarkę do najnowszej wersji – starsze wersje mogą używać przestarzałych protokołów
- Przetestuj w innej przeglądarce lub na innym urządzeniu – jeśli błąd zniknie, problem jest lokalny
- Skontaktuj się z administratorem strony – jeśli żaden z powyższych kroków nie pomógł
Kluczowa zasada: jeśli błąd HTTP 505 pojawia się we wszystkich przeglądarkach i na wszystkich urządzeniach, wina leży po stronie serwera. W takiej sytuacji użytkownik nie jest w stanie samodzielnie rozwiązać problemu i powinien zgłosić go administratorowi lub dostawcy hostingu.
Błąd HTTP 505 a SEO – wpływ na indeksowanie i crawl budget
Błąd HTTP 505 blokuje Googlebotowi dostęp do strony, marnuje crawl budget i może doprowadzić do usunięcia podstrony z indeksu – szczególnie jeśli utrzymuje się dłużej niż kilka dni.
Mechanizm jest następujący: Googlebot wysyła żądanie HTTP do serwera, serwer zwraca kod 505 zamiast treści strony, a bot rejestruje błąd i przechodzi do kolejnego URL-a. Każde takie nieudane żądanie zużywa crawl budget – limit żądań, które Google przydziela domenie w danej sesji crawlowania.
Skutki błędu HTTP 505 dla SEO obejmują trzy poziomy:
- Krótkoterminowe (1-3 dni) – podstrona nie jest indeksowana, traci świeżość w wynikach wyszukiwania
- Średnioterminowe (1-2 tygodnie) – Google może tymczasowo usunąć podstronę z indeksu, ranking spada
- Długoterminowe (ponad 30 dni) – trwałe usunięcie z indeksu, utrata pozycji i ruchu organicznego
Po naprawie błędu powrót strony do indeksu może trwać od kilku dni do kilku tygodni, w zależności od autorytetu domeny i częstotliwości crawlowania. Monitorowanie statusu indeksowania umożliwiają narzędzia: Google Search Console (raport „Strony”), Screaming Frog (audyt kodów odpowiedzi) i Ahrefs (raport „Best by links” z filtrem 5xx).
Jak zapobiegać błędowi 505? Profilaktyka serwera
Systematyczna profilaktyka błędu HTTP 505 opiera się na regularnych aktualizacjach serwera, precyzyjnej konfiguracji obsługiwanych wersji protokołu i monitorowaniu logów – zanim błąd dotrze do użytkowników. Poniższe 6 działań minimalizuje ryzyko wystąpienia kodu 505.
- Aktualizuj Apache i Nginx do najnowszych stabilnych wersji – Apache 2.4.x i Nginx 1.25.x wspierają HTTP/2 i HTTP/3 natywnie
- Utrzymuj obsługę wielu wersji HTTP jednocześnie – dyrektywa
Protocols h2 http/1.1w Apache zapewnia kompatybilność wstecz z klientami używającymi starszych protokołów - Monitoruj logi serwera codziennie lub skonfiguruj alerty – pierwsze wpisy z kodem 505 w error.log sygnalizują problem, zanim dotknie on wszystkich użytkowników
- Testuj konfigurację po każdej zmianie – po aktualizacji, migracji lub edycji plików conf uruchom komendy
curl -v --http2inginx -t(lubapachectl configtest) - Wdróż load balancing i caching – load balancer rozdziela ruch między serwerami, a caching (np. Varnish, Redis) zmniejsza liczbę żądań trafiających do backendu
- Stosuj percent-encoding w URL-ach – waliduj adresy URL w aplikacji, aby uniknąć nieodkodowanych spacji i znaków specjalnych, które mogą generować błędny request-line
Regularne testy automatyczne (np. za pomocą cron i skryptu curl sprawdzającego kody odpowiedzi) pozwalają wykryć błąd HTTP 505 w ciągu minut od jego pojawienia się.
FAQ – najczęściej zadawane pytania o błąd 505
Jak naprawić błąd HTTP 505?
Błąd HTTP 505 naprawia się najczęściej po stronie serwera – włączając obsługę odpowiedniej wersji protokołu HTTP. W Apache dodaj dyrektywę Protocols h2 http/1.1 w bloku VirtualHost, w Nginx dodaj http2 do dyrektywy listen 443 ssl. Po zmianie konfiguracji zrestartuj usługę komendą sudo systemctl restart apache2 lub sudo systemctl restart nginx.
Co oznacza błąd serwera 505?
Błąd serwera 505 oznacza, że serwer nie obsługuje wersji protokołu HTTP użytej w żądaniu klienta. Pełna nazwa tego kodu to HTTP Version Not Supported, a jego specyfikację definiuje dokument RFC 9110. Jest to jeden z najrzadszych kodów odpowiedzi z grupy 5xx.
Co oznacza błąd HTTP 505?
Błąd HTTP 505 (HTTP Version Not Supported) informuje, że serwer odmawia przetworzenia żądania z powodu nieobsługiwanej wersji protokołu. Typowa sytuacja: klient wysyła żądanie HTTP/2, a serwer jest skonfigurowany wyłącznie na HTTP/1.1. Rozwiązanie wymaga aktualizacji konfiguracji serwera.
Jak naprawić HTTP Error 500?
Błąd HTTP 500 (Internal Server Error) to odrębny problem od błędu 505 – wynika z wewnętrznego błędu serwera, nie z niezgodności wersji protokołu. Naprawa obejmuje sprawdzenie logów aplikacji, uprawnień plików, limitów pamięci PHP i poprawności pliku .htaccess. W WordPress najczęstszą przyczyną jest konflikt wtyczek lub uszkodzony plik functions.php.
Czy błąd 505 to zawsze wina serwera?
Nie – błąd HTTP 505 może wynikać zarówno z konfiguracji serwera, jak i z problemów po stronie klienta. Jeśli błąd pojawia się we wszystkich przeglądarkach, odpowiada serwer. Jeśli tylko w jednej przeglądarce lub na jednym urządzeniu – przyczyna leży po stronie klienta (np. przestarzała przeglądarka lub rozszerzenie modyfikujące nagłówki HTTP).
Czy błąd 505 wpływa na SEO?
Tak – błąd HTTP 505 blokuje Googlebotowi dostęp do strony i marnuje crawl budget. Utrzymywanie się błędu przez ponad tydzień może skutkować usunięciem podstrony z indeksu Google. Monitoruj kody odpowiedzi w Google Search Console, aby szybko wykrywać i naprawiać takie problemy.
Jaka jest różnica między błędem 505 a 500?
Błąd 505 oznacza niezgodność wersji protokołu HTTP między klientem a serwerem, natomiast błąd 500 to ogólny wewnętrzny błąd serwera (np. błąd skryptu PHP, przekroczenie limitu pamięci). Diagnostyka 505 koncentruje się na konfiguracji protokołu, a 500 – na logach aplikacji i kodzie źródłowym.
Co to jest request-line i jak może powodować błąd 505?
Request-line to pierwsza linia żądania HTTP zawierająca metodę, ścieżkę i wersję protokołu (np. GET /strona HTTP/1.1). Jeśli URL zawiera nieodkodowane spacje, serwer może błędnie zinterpretować fragment ścieżki jako wersję HTTP i zwrócić błąd 505. Rozwiązanie to stosowanie percent-encoding w adresach URL.
Jak sprawdzić, czy serwer obsługuje HTTP/2?
Najszybszą metodą sprawdzenia obsługi HTTP/2 jest komenda curl -v --http2 https://twojadomena.pl/. Jeśli w odpowiedzi pojawi się nagłówek < HTTP/2 200, serwer obsługuje HTTP/2 poprawnie. Alternatywnie otwórz DevTools w przeglądarce (F12), zakładkę Network, i sprawdź kolumnę Protocol – wartość h2 oznacza HTTP/2.
Czy błąd 505 może wywołać wtyczka WordPress?
Tak – wtyczki WordPress mogą pośrednio powodować błąd HTTP 505, szczególnie wtyczki cache, CDN lub bezpieczeństwa, które modyfikują nagłówki HTTP odpowiedzi. Diagnostyka obejmuje wyłączenie wszystkich wtyczek (zmiana nazwy katalogu /wp-content/plugins/) i stopniowe włączanie ich pojedynczo, aby zlokalizować konflikt.
