101 Switching Protocols to kod odpowiedzi HTML z rodziny 1xx (odpowiedzi informacyjne), którym serwer potwierdza zgodę na zmianę protokołu komunikacji zainicjowaną przez klienta w nagłówku Upgrade. W praktyce oznacza on „ok, przełączam się na protokół, o który prosiłeś” i najczęściej pojawia się przy nawiązywaniu połączeń WebSocket lub przy przejściu z HTTP/1.1 na inny protokół w ramach tego samego połączenia TCP.
Kod 101 nie jest błędem ani sygnałem sukcesu w klasycznym rozumieniu — to techniczne potwierdzenie handshake’u. Dla zwykłego użytkownika przeglądarki pozostaje niewidoczny, ale dla aplikacji czasu rzeczywistego jest fundamentem działania.
Jak 101 Switching Protocols działa w praktyce
Odpowiedź 101 pojawia się w momencie, gdy klient wysyła żądanie z nagłówkiem Upgrade, a serwer akceptuje zmianę protokołu. Cała procedura odbywa się w ramach jednego połączenia — nie ma potrzeby zestawiania nowego kanału TCP, co przyspiesza start komunikacji dwukierunkowej.
Rola nagłówka Upgrade w handshake’u
Nagłówek Upgrade to mechanizm, który pozwala klientowi zaproponować przejście na inny protokół w trakcie trwającego połączenia HTTP. Klient wysyła żądanie zawierające m.in. Connection: Upgrade oraz Upgrade: websocket, a serwer, jeśli obsługuje daną technologię, odpowiada statusem 101 i potwierdza nowy protokół w swoich nagłówkach.
Typowa odpowiedź serwera wygląda tak:
HTTP/1.1 101 Switching ProtocolsUpgrade: websocketConnection: UpgradeSec-WebSocket-Accept: [wygenerowany klucz]
Gdzie najczęściej spotkasz kod 101
Najczęstszym zastosowaniem 101 Switching Protocols jest inicjalizacja połączenia WebSocket. To właśnie ten protokół napędza czaty na żywo, powiadomienia push, aplikacje kolaboracyjne (np. edytory dokumentów w czasie rzeczywistym) czy notowania giełdowe aktualizowane bez odświeżania strony.
Poza WebSocketem kod 101 bywa wykorzystywany przy przełączaniu na HTTP/2 w środowiskach, które go nie negocjują przez ALPN podczas handshake’u TLS. W ekosystemie przeglądarek dominuje jednak scenariusz z WebSocketem.
Kody 1xx w tabeli porównawczej
| Kod | Nazwa | Znaczenie |
|---|---|---|
| 100 | Continue | Serwer otrzymał nagłówki i klient może kontynuować wysyłanie treści żądania. |
| 101 | Switching Protocols | Serwer akceptuje zmianę protokołu wskazaną w nagłówku Upgrade. |
| 103 | Early Hints | Serwer wysyła wstępne wskazówki (np. preload zasobów) przed finalną odpowiedzią. |
Znaczenie dla SEO i widoczności
Kod 101 Switching Protocols nie wpływa bezpośrednio na indeksowanie ani rankingi, ponieważ dotyczy komunikacji między aplikacją a serwerem, a nie renderowania treści dla robota Google. Googlebot nie negocjuje połączeń WebSocket, więc nie interpretuje statusu 101 jak zwykłej odpowiedzi HTML.
Pośrednio ma jednak znaczenie dla doświadczenia użytkownika i wskaźników Core Web Vitals. Aplikacje oparte na WebSocketach dostarczają dane w czasie rzeczywistym bez pełnego przeładowania strony, co odciąża serwer i skraca czas interakcji. W praktyce SEO problem pojawia się wtedy, gdy dynamiczne treści ładowane przez WebSocket nie mają statycznego odpowiednika w HTML — wtedy robot ich nie zobaczy.
W naszej codziennej pracy przy audycie SEO zwracamy uwagę, by treści istotne dla pozycjonowania były dostępne w źródle strony lub renderowane po stronie serwera, a nie wyłącznie dociągane przez połączenie WebSocket po załadowaniu widoku.
FAQ
Czy kod 101 oznacza błąd na stronie?
Nie, 101 Switching Protocols nie jest błędem. To informacyjna odpowiedź serwera potwierdzająca zgodę na zmianę protokołu, najczęściej na WebSocket. Jego obecność w narzędziach deweloperskich oznacza, że połączenie zostało poprawnie nawiązane.
Jak sprawdzić, czy serwer zwraca status 101?
Otwórz narzędzia deweloperskie w przeglądarce (F12), przejdź do zakładki Sieć (Network) i przefiltruj żądania po typie WS (WebSocket). Przy poprawnie zestawionym połączeniu zobaczysz status 101 Switching Protocols wraz z nagłówkami Upgrade i Connection.
Czym różni się kod 101 od kodu 200?
Kod 200 OK oznacza pomyślne zakończenie żądania i zwrócenie żądanej treści, kończąc transakcję. Kod 101 nie kończy komunikacji — przeciwnie, sygnalizuje, że połączenie zostaje utrzymane i przełączone na inny protokół, aby umożliwić dalszą, dwukierunkową wymianę danych.
Co zrobić, gdy WebSocket nie zwraca statusu 101?
Najczęstszą przyczyną jest błędna konfiguracja serwera lub proxy pośredniczącego, który nie przekazuje nagłówków Upgrade i Connection. Sprawdź ustawienia reverse proxy (Nginx, Apache, Cloudflare) oraz upewnij się, że firewall i load balancer obsługują ruch WebSocket na danym porcie.
Krótka ściąga na koniec o kodzie 101
101 Switching Protocols to cichy bohater aplikacji czasu rzeczywistego — potwierdza przejście na WebSocket i utrzymuje otwarty kanał komunikacji. Choć nie wpływa wprost na rankingi, jego prawidłowa konfiguracja przekłada się na płynność działania serwisu i satysfakcję użytkownika. Jeśli chcesz mieć pewność, że Twoja strona jest technicznie w porządku i gotowa na pozycjonowanie stron, sprawdzimy to podczas kompleksowego audytu SEO.
