Błąd ERRFILENOTFOUND (w pełnej wersji: net::ERRFILENOTFOUND) to problem, który pojawia się najczęściej w przeglądarce Google Chrome i oznacza, że przeglądarka nie może znaleźć lub załadować konkretnego pliku potrzebnego do wyświetlenia strony lub jej elementu. Komunikat może być widoczny zarówno podczas serfowania po sieci, jak i przy pracy z lokalnymi plikami (np. testowaniu aplikacji webowej na swoim komputerze).
Spis treści
Najczęstsze przyczyny błędu
- Plik został usunięty, przeniesiony lub zmieniona jego nazwa – najprostszy powód. Jeśli strona próbuje załadować plik, którego nie ma (np. obraz, CSS, JavaScript), pojawia się błąd.
- Błędny adres URL lub literówka – zła ścieżka do zasobu (np. wpisana wielkość liter, brakująca końcówka .html).
- Problemy z rozszerzeniami Chrome – niektóre rozszerzenia mogą zakłócać poprawną pracę Chrome i powodować ten komunikat na stronach, które nieświadomie modyfikują.
- Uszkodzone lub nieaktualne cache/przechowalnia przeglądarki – przechowywane dane mogą być przestarzałe, prowadząc do błędów podczas ładowania strony.
- Problem po stronie serwera – rzadziej, ale serwer może niepoprawnie obsługiwać zapytanie o plik (brak odpowiedzi 404, zła konfiguracja serwera).
- Pliki zabrane przez złośliwe oprogramowanie – w skrajnych przypadkach pliki mogą być usuwane przez wirusy.
- Problemy z kartą pamięci lub dyskiem – przy próbie otwarcia pliku lokalnie, np. z pendrive’a lub karty SD.
Kto jest narażony na błąd?
- Użytkownicy końcowi – widzą komunikat podczas przeglądania witryn, próbując otworzyć lokalny plik lub po zainstalowaniu wadliwego rozszerzenia.
- Webmasterzy i developerzy – najczęściej napotykają błąd podczas testowania własnych stron, gdy zasób został źle wczytany, usunięty, źle skopiowany na serwer albo gdy testują stronę lokalnie (file://).
Rozwiązania krok po kroku
Dla użytkownika końcowego
- Odśwież stronę
Skorzystaj z kombinacji klawiszy Ctrl + F5 (Windows) lub Cmd + Shift + R (macOS), aby silnie odświeżyć stronę i zignorować cache przeglądarki. - Sprawdź adres strony/aplikacji
Upewnij się, że nie ma literówek, błędnych spacji czy znaków specjalnych (np. %20 zamiast spacji). - Wyłącz rozszerzenia Chrome
W Chrome kliknij ikonę z trzema kropkami → Więcej narzędzi → Rozszerzenia.
Wyłącz wszystkie rozszerzenia, wyłączając pojedyncze przełączniki.
Po każdej zmianie przeładuj stronę (Ctrl + F5) i sprawdź, czy błąd zniknął. - Wyczyść pamięć podręczną przeglądarki
Wejdź w Ustawienia Chrome → Prywatność i bezpieczeństwo → Wyczyść dane przeglądania.
Wybierz „Pliki cookie i inne dane witryn” oraz „Obrazy i pliki zapisane w pamięci podręcznej”. - Zresetuj Chrome do ustawień domyślnych
W Ustawienia przewiń na dół i kliknij „Resetuj ustawienia” → „Przywróć ustawienia do wartości domyślnych”. - Sprawdź plik na innym urządzeniu lub przeglądarce
Jeśli problem dotyczy tylko jednego komputera, powtórz próbę na innym urządzeniu lub zmień przeglądarkę. - Skanuj komputer pod kątem wirusów
Jeśli podejrzewasz, że plik zaginął przez szkodliwe oprogramowanie, wykonaj skanowanie systemu. - Spróbuj odzyskać plik
Jeśli problem dotyczy lokalnego pliku, korzystając z oprogramowania do odzyskiwania danych, spróbuj przywrócić plik.
Dla webmastera/developera
- Sprawdź czy plik istnieje na serwerze
Upewnij się, że zasób (np. obraz, CSS, JS) znajduje się pod wskazaną ścieżką.
Dla Unix/Linux:
ls -la /ścieżka/do/katalogu Dla Windows:
Otwórz Eksplorator i przejdź do katalogu docelowego.
- Sprawdź wielkość liter w nazwie pliku
Serwery Unix/Linux są wrażliwe na wielkość liter (np. styles.css a Styles.css). - Sprawdź uprawnienia do pliku
Plik musi być czytelny dla użytkownika, pod którym działa serwer (np. Apache, nginx):
chmod 644 /ścieżka/do/pliku - Upewnij się, że .htaccess/config serwera nie blokuje dostępu
Sprawdź plik .htaccess (Apache) lub konfigurację serwera (nginx) pod kątem reguł restrict. - Otwórz narzędzia deweloperskie (F12)
W zakładce Sieć zobaczysz, które zasoby się nie ładowały i dlaczego (np. 404). - Zweryfikuj adresy URL w kodzie
Upewnij się, że ścieżki w HTML, CSS, JS są poprawne względem struktury projektu. - Wyczyść cache serwera i CDN
Jeśli używasz cache po stronie serwera lub CDN, wyczyść je po zmianach. - Zaktualizuj rozszerzenia Chrome lub wtyczki developerskie
Jeśli błąd występuje tylko w Chrome, szczególnie podczas pracy lokalnej, wyłącz rozszerzenia lub zaktualizuj je. - Zweryfikuj ścieżki w plikach manifestu (np. dla Progressive Web App)
Jeśli błąd dotyczy PWA, sprawdź plikmanifest.jsoniservice-worker.js. - Przetestuj aplikację na innych przeglądarkach i urządzeniach
Potwierdź, że problem dotyczy tylko danego środowiska.
Tabela: Najczęstsze przyczyny i rozwiązania ERRFILENOT_FOUND
| Przyczyna | Dla użytkownika | Dla webmastera/developera |
|---|---|---|
| Brak pliku | Sprawdź ścieżkę, przenieś/usuń | Zdeployuj brakujący plik |
| Błędny adres URL | Sprawdź wpisany adres | Popraw ścieżki w kodzie |
| Problemy z rozszerzeniami | Wyłącz/zaktualizuj rozszerzenia | Wyłącz developerskie wtyczki |
| Cache | Wyczyść pamięć podręczną | Wyczyść cache serwera/CDN |
| Złośliwe oprogramowanie | Skanuj system | – |
| Uprawnienia do pliku | – | Ustaw prawa chmod na 644 |
| .htaccess/blokada serwera | – | Sprawdź reguły .htaccess |
Dodatkowe wskazówki i wyjaśnienia
- Błąd ERRFILENOTFOUND to nie to samo co HTTP 404 – choć oba oznaczają „nie znaleziono pliku”, ERRFILENOTFOUND to błąd po stronie przeglądarki, a 404 to odpowiedź serwera.
- Błąd może pojawić się tylko w Chrome – inne przeglądarki nie zawsze zgłaszają ten sam komunikat, co może ułatwiać diagnozę.
- Podczas pracy lokalnej (file://) błąd oznacza najczęściej, że plik został źle nazwany, przeniesiony lub usunięty.
- Jeśli działa na serwerze produkcyjnym, a nie lokalnie – sprawdź struktury katalogów, ścieżki względne i wielkość liter.
- Jeśli wypróbowałeś wszystkie powyższe metody, rozważ ponowne pobranie lub odtworzenie projektu.
Podsumowanie
Błąd ERRFILENOT_FOUND najczęściej jest prosty do naprawy, jeśli dokładnie sprawdzisz, czego brakuje i dlaczego przeglądarka nie może tego znaleźć. Dla użytkownika końcowego kluczowe jest wyłączenie rozszerzeń i czyszczenie cache, a dla webmastera – weryfikacja ścieżek, uprawnień i poprawności wdrożenia plików na serwer. W skrajnych przypadkach przydatne może być odzyskanie utraconych danych lub reinstalacja przeglądarki.
Pamiętaj – Jeśli błąd dotyczy tylko jednej przeglądarki, problemem są najprawdopodobniej rozszerzenia lub konflikt z cache’em. Jeśli pojawia się wszędzie, sprawdź pliki na serwerze i ich ścieżki!
