Błąd ERR_CONTENT_DECODING_FAILED – przyczyny i naprawa

Błąd ERRCONTENTDECODING_FAILED oznacza, że przeglądarka nie może poprawnie zdekodować przesłanych przez serwer danych, zwykle z powodu nieprawidłowej konfiguracji kompresji, problemów z zaporą sieciową lub nieaktualnych danych DNS. Poniżej znajduje się szczegółowy poradnik dla webmasterów, deweloperów oraz użytkowników końcowych, z pełnym omówieniem przyczyn, wyjaśnieniem działania i instrukcjami naprawczymi.

Czym jest błąd ERRCONTENTDECODING_FAILED?

ERRCONTENTDECODING_FAILED pojawia się, gdy przeglądarka oczekuje skompresowanego zasobu (np. GZIP), ale otrzymuje nieprawidłowo zakodowane, nieskompresowane lub częściowo uszkodzone dane. Typowo dotyczy to stron www, których serwery niepoprawnie deklarują nagłówki „Content-Encoding” lub przerywają kompresję danych w trakcie przesyłania.

Najczęstsze przyczyny błędu

• Niewłaściwa konfiguracja kompresji GZIP/Brotli – serwer przesyła nagłówek Content-Encoding: gzip, ale nie kompresuje treści zgodnie z tym standardem, lub plik jest uszkodzony.
• Awaria lub niezgodność proxy/VPN – pośredniczący serwer zmienia lub uszkadza przesyłane dane.
• Zapora sieciowa (firewall), antywirus, filtry sieciowe – blokują lub modyfikują ruch.
• Uszkodzona pamięć podręczna przeglądarki lub DNS – błędne wersje plików lub stare wpisy DNS mogą utrwalać problem.
• Błąd po stronie przeglądarki – błędnie zinterpretowana odpowiedź HTTP.
• Nieprawidłowe lub przestarzałe ustawienia DNS – negatywnie wpływają na przesyłanie danych oraz dekodowanie treści.

Naprawa – Instrukcja dla webmastera / web dewelopera

Najpierw ustal, czy problem dotyczy wszystkich użytkowników, konkretnej przeglądarki, czy tylko Twojego środowiska.

1. Sprawdź nagłówki HTTP i konfigurację kompresji

• W narzędziach deweloperskich (zakładka Network):
• Upewnij się, że nagłówek Content-Encoding odpowiada faktycznej kompresji danych.
• Przykład – Gdy Content-Encoding: gzip, odpowiedź MUSI być poprawnie skompresowana w formacie GZIP.
• Jeśli korzystasz z Apache:
• Edytuj plik .htaccess i tymczasowo wyłącz GZIP: SetEnv no-gzip 1
• W Nginx sprawdź / zmodyfikuj sekcję: gzip on; Tymczasowo ustaw gzip off; i zrestartuj serwer.
• Jeśli masz proxy (np. Cloudflare, reverse proxy), wyłącz/zmień ustawienia kompresji i przetestuj zarówno z, jak i bez niego.

2. Weryfikacja konfiguracji proxy/VPN

• Wyłącz serwery pośredniczące, CDN, VPN lub proxy i sprawdź ponownie czy problem występuje.

3. Opróżnij cache backendu, frontendu oraz przeglądarki

• Wyczyść cache WordPressa/Joomli/drugiego CMS-a.
• Upewnij się, że serwery CDN (np. Cloudflare) mają odświeżone/wyczyszczone cache.

4. Test na czysto (tryb „incognito” + brak cache)

• Otwórz stronę bez cache (Ctrl+Shift+R).

5. Sprawdź ustawienia DNS

• Użyj publicznego DNS od Google (8.8.8.8, 8.8.4.4) lub Cloudflare (1.1.1.1).
• Zrestartuj serwer DNS (lub „flush” DNS poleceniem):
• Windows:
  ipconfig /flushdns
• MacOS:
  sudo killall -HUP mDNSResponder
• Odśwież cache SSL/TLS na serwerze, jeśli korzystasz z HTTP/2.

Szybka instrukcja dla użytkownika końcowego

1. Odśwież stronę, spróbuj trybu incognito.
2. Wyczyść cache przeglądarki oraz cookies –
   • Chrome: Menu (⋮) → „Więcej narzędzi” → „Wyczyść dane przeglądania”.
   • Firefox: Menu (☰) → „Prywatność i bezpieczeństwo” → „Ciasteczka i dane stron” → „Wyczyść dane”.
3. Zmień serwer DNS na Google (8.8.8.8, 8.8.4.4) lub Cloudflare (1.1.1.1) w ustawieniach sieci.
4. Jeśli to możliwe, wyłącz zaporę sieciową/antywirusa na czas testu.
5. Flushing DNS (Windows: „ipconfig /flushdns” w Wierszu poleceń, Mac: „sudo killall -HUP mDNSResponder” w Terminalu).
6. Flush socket pools (w Chrome: wpisz w pasku „chrome://net-internals/#sockets” i kliknij „Flush socket pools”).
7. Zrestartuj przeglądarkę i komputer.

Najczęściej zadawane pytania (FAQ)

Jakie przeglądarki są podatne?
Występuje zarówno w Chrome, jak i Firefox, Edge, Safari.

Czy błąd oznacza atak hakerski?
Nie, często to błąd konfiguracji lub sprzętu; jednak incydentalnie może świadczyć o próbie modyfikacji ruchu przez szkodliwe sieci/proxy.

Czy błędy mogą być po stronie hostingu?
Tak, często hosting lub chmura CDN wprowadza kompresję, która jest skonfigurowana nieprawidłowo.

Czy można wymusić wyłączenie kompresji na konkretnej stronie?
Tak, przez odpowiednie reguły w pliku .htaccess lub konfiguracji serwera.

Podsumowanie

• Dla webmastera – Skup się na poprawnej kompresji oraz nagłówkach HTTP, sprawdź CDN/proxy.
• Dla użytkownika – Zacznij od prostych rzeczy – wyczyszczenie cache, zmiana DNS, restart przeglądarki, testowanie na innej sieci/urządzeniu.

Powyższe kroki rozwiążą zdecydowaną większość problemów z ERRCONTENTDECODING_FAILED.