Błąd ERRADDRESSIN_USE oznacza, że dany adres IP lub port, na którym próbujesz uruchomić usługę (np. serwer WWW lub aplikację webową), jest już zajęty przez inny proces lub aplikację na tym samym komputerze. Często pojawia się podczas pracy programistycznej (np. w Node.js, Dockerze, serwerach lokalnych), ale może być widoczny również dla zwykłych użytkowników podczas pracy z przeglądarką lub siecią lokalną.
Wyjaśnienie przyczyn błędu
- Port jest już zajęty – inna aplikacja nasłuchuje na tym porcie.
- Instancja serwera już działa – próbujesz uruchomić serwer, który już działa z tym adresem/portem.
- Błędna konfiguracja sieci lub firewalla – port został zablokowany lub przekierowany.
- Konflikt aplikacji – np. dwie instancje tej samej aplikacji próbują korzystać z tego samego portu.
- Problemy z backendem lub proxy – serwer, reverse proxy lub narzędzie developerskie blokuje port.
Dla webmastera/web dewelopera – naprawa krok po kroku
1. Identyfikacja procesu zajmującego port
W systemie Windows –
netstat -ano | findstr :PORT Podmień PORT na numer portu (np. 3000). Otrzymasz PID (identyfikator procesu).
Następnie:
tasklist /FI "PID eq numerek_PID" W systemie Linux/macOS –
lsof -i :PORT albo:
netstat -tuln | grep PORT 2. Zakończ proces blokujący port
W systemie Windows –
taskkill /PID numerek_PID /F W systemie Linux/macOS –
kill -9 numerek_PID Uwaga: Niektóre procesy mogą być systemowe lub krytyczne – uważnie sprawdź, czy można je zakończyć.
3. Uruchom serwer ponownie
W większości przypadków po zwolnieniu portu uruchomienie serwera webowego powiedzie się bez błędu.
4. Zmień port w konfiguracji
Jeśli nie możesz zakończyć procesu lub port jest potrzebny, zmień port w ustawieniach aplikacji:
- Dla Node.js: ustaw inną wartość w
process.env.PORTlub w pliku konfiguracyjnym. - Dla Apache/Nginx: zmodyfikuj sekcję
Listenlub konfigurację wirtualnego hosta.
5. Sprawdź firewall i przekierowania portów
- Zweryfikuj ustawienia firewalla i routera, by wykluczyć blokowanie lub konflikt trasowania.
Dla użytkownika końcowego – najprostsze rozwiązania
-
Zamknij inne programy korzystające z sieci (np. Skype, Discord, Web Server).
-
Uruchom ponownie komputer oraz router – często problem znika po restarcie sprzętu.
-
Zmień przeglądarkę – sprawdź, czy błąd pojawia się tylko w jednej (część błędów jest związana tylko z Chrome).
-
Wyczyść cache DNS i przeglądarki – szczególnie dla błędów związanych z DNS lub konfiguracją sieci:
W Chrome: wpisz
chrome://net-internals/#dnsi kliknij „Clear host cache”.W systemie Windows:
ipconfig /flushdnsW systemie macOS:
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder -
Wyłącz proxy lub VPN – czasem pośredniczą między Twoją przeglądarką a siecią, prowadząc do konfliktów.
Przydatne wskazówki i uwagi
- Unikaj uruchamiania kilku serwerów lokalnych na tym samym porcie (np. dwie aplikacje na
localhost:3000). - Sprawdzaj uprawnienia administratora – serwery wymagają często uprawnień do otwierania portów poniżej 1024.
- Logi debugowania – zawsze sprawdzaj logi aplikacji i serwera, które precyzyjnie pokażą powód niedostępności portu.
Tabela – typowe przyczyny i rozwiązania
| Przyczyna | Dla dewelopera | Dla użytkownika końcowego |
|---|---|---|
| Port zajęty przez inny proces | Znajdź i zabij proces, zmień port | Zamknij niepotrzebne aplikacje |
| Działająca instancja serwera | Sprawdź procesy, zakoń nadmiarowe | Uruchom ponownie komputer |
| Błędny firewall lub router | Skonfiguruj wyjątki, przekierowania | Zrestartuj router |
| Konflikt aplikacji | Przeorganizuj aplikacje i porty | Wyłącz zbędne programy |
| Cache DNS/przeglądarki | Wyczyść cache DNS/systemowy | Wyczyść cache DNS/przeglądarki |
Błąd ERRADDRESSIN_USE jest jednym z najczęściej spotykanych przez web deweloperów oraz administratorów systemów – wynikający z kolizji portów lub powielonego uruchamiania aplikacji. Rozwiązania są dostępne zarówno dla zaawansowanych użytkowników, jak i dla osób nietechnicznych, zwykle nie wymagając dużej wiedzy technicznej.
