Błąd ERR_RESPONSE_HEADERS_TRUNCATED – przyczyny i naprawa

Błąd ERRRESPONSEHEADERS_TRUNCATED występuje najczęściej podczas korzystania z przeglądarki Google Chrome (choć można go spotkać także w innych przeglądarkach opartych na Chromium) i oznacza problem z przesyłaniem nagłówków HTTP/HTTPS z serwera do przeglądarki. Ten błąd uniemożliwia poprawne załadowanie strony przez użytkownika.

Wyjaśnienie błędu ERRRESPONSEHEADERS_TRUNCATED

Co oznacza ten błąd?

• Przeglądarka spodziewa się pełnego, poprawnego zestawu nagłówków HTTP/HTTPS.
• Jeśli odpowiedź serwera zostaje przerwana, nagłówki są niekompletne lub zbyt długie, Chrome nie jest w stanie ich poprawnie zinterpretować, co skutkuje komunikatem „ERRRESPONSEHEADERS_TRUNCATED”.

Najczęstsze przyczyny –

• Proxy lub load balancer (np. NGINX) przekazuje niepełne/częściowo ucięte nagłówki do klienta.
• Błędy aplikacyjne – np. niepoprawna obsługa nagłówków w zapleczu aplikacji.
• Przekroczenie dozwolonej liczby/długości nagłówków przez serwer.
• Problemy związane z obsługą HTTPS i terminacją SSL.
• Zerwanie połączenia przez backend (np. błąd 503 lub connection reset).

Instrukcje naprawy dla webmastera/web developera

1. Sprawdź logi serwera i przeglądarki

• Przejrzyj logi serwera HTTP(S) (np. Apache, NGINX), aplikacji oraz reverse proxy lub load balancera pod kątem błędów w momencie występowania błędu.
• Otwórz DevTools (F12 → Network) i znajdź szczegóły odpowiedzi HTTP wraz z otrzymanymi nagłówkami.

2. Zaktualizuj ustawienia reverse proxy/load balancera

• Zweryfikuj konfigurację reverse proxy, np. NGINX:

proxy_http_version 1.1; proxy_set_header Connection ""; 

• Upewnij się, że nie przekazuje on niepoprawnych lub pustych nagłówków.
• Zwiększ limity — przykładowo w NGINX:

large_client_header_buffers 4 16k; 

• Upewnij się, że SSL jest poprawnie zakończony na proxy, jeśli jest stosowane.

3. Zweryfikuj backend

• Upewnij się, że backend (np. aplikacja na Node.js, Java, PHP) wysyła kompletne i poprawne nagłówki HTTP (przykład: brak Content-Length, np. przez nieskończony streaming – błąd!).
• Sprawdź, czy aplikacja nie kończy połączenia zanim zostaną wysłane wszystkie nagłówki.

4. Wyklucz błędy sieciowe i zewnętrzne

• Upewnij się, że nie występują po drodze żadne translacje czy błędy na firewallu, CDN, usługach pośredniczących.
• Skonfiguruj test na innym połączeniu lub z innym dostawcą internetu, by wykluczyć błędy trasowania.

5. Przetestuj bezpośrednie połączenie

• Spróbuj uzyskać dostęp do aplikacji backendowej z pominięciem proxy (np. przez bezpośredni port) i porównaj wyniki.

Instrukcja naprawy — krok po kroku

Przykład dla administratora NGINX –

1. Otwórz plik konfiguracyjny NGINX i sprawdź sekcje proxy_set_header.
2. Dodaj lub zmodyfikuj linie w location: nginx proxy_http_version 1.1; proxy_set_header Connection "";
3. Jeśli występują bardzo długie nagłówki, zwiększ rozmiar bufforów: nginx large_client_header_buffers 4 16k;
4. Przeładuj konfigurację i sprawdź, czy błąd ustąpił.
5. Jeśli nie — sprawdź logi błędów i połącz się bezpośrednio do backendu, aby zweryfikować, czy problem nie leży po stronie aplikacji lub innej warstwy serwera.

Instrukcje dla użytkownika końcowego

• Odśwież stronę (F5 lub Ctrl+F5)
• Wyłącz proxy/vpn jeśli korzystasz, ponieważ mogą one „ucinać” nagłówki.
• Spróbuj innej przeglądarki – błąd jest charakterystyczny dla Chrome, ale możesz sprawdzić w Firefoxie lub Edge.
• Zgłoś administratorowi strony wraz z informacją o błędzie i czasie wystąpienia, co ułatwi diagnostykę.

Dodatkowe informacje i wyjaśnienia

• Błąd nie leży zwykle po stronie przeglądarki i rzadko pomaga czyszczenie cache.
• Najczęściej problem napotyka się w architekturze z reverse proxy lub load balancerem.
• Może być wywołany niekompatybilnością między połączeniami HTTPS/HTTP – np. proxy kończy SSL, a backend działa po HTTP (mieszanie protokołów).
• Warto również sprawdzić, czy nie występują błąd 503 w logach, który ten komunikat może maskować.

Podsumowanie najważniejszych zaleceń dla webmastera/web developera

• Skontroluj i popraw konfigurację reverse proxy.
• Sprawdź kompletność nagłówków HTTP aplikacji backendowej.
• Zwiększ limity oraz bufory dla nagłówków na serwerze proxy.
• Regularnie analizuj logi błędów i testuj dostępność backendu bez pośredników.
• Dla użytkowników końcowych: informuj administratora o błędzie — nie jest on winą użytkownika.