java.net.BindException: Address already in use
Serverul tău încearcă să pornească pe un port ocupat deja de alt program, de obicei o instanță veche a aceleiași aplicații rămasă pornită. Oprește procesul vechi sau pornește serverul pe alt port.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un port poate fi ascultat de un singur program la un moment dat (pe aceeași adresă). Când un ServerSocket (sau un server Ktor, Spring Boot, Netty) încearcă să se lege (bind) de un port deja folosit, sistemul de operare refuză și primești BindException: Address already in use.
Cauze tipice:
- ai pornit aplicația de două ori din IDE, iar prima rulează încă;
- un proces a rămas în fundal după o oprire forțată;
- alt program folosește portul (
8080e popular: alte servere, proxy-uri, Docker); - în cod, două componente pornesc server pe același port.
Află cine ține portul: lsof -i :8080 pe macOS/Linux, netstat -ano | findstr 8080 pe Windows, apoi oprește procesul sau schimbă portul în configurare. În Spring Boot mesajul apare ca Port 8080 was already in use.
De ce apare: cauzele frecvente
1Instanța veche încă pornită
embeddedServer(Netty, port = 8080) { }.start(wait = true)// opreste instanta veche (butonul Stop din IDE) sau:
embeddedServer(Netty, port = 8081) { }.start(wait = true)Fie eliberezi portul, fie alegi altul liber.
2Două servere pe același port în cod
val api = ServerSocket(9000)
val admin = ServerSocket(9000)val api = ServerSocket(9000)
val admin = ServerSocket(9001)Fiecare server are nevoie de portul lui.
3Port fix în teste
val server = ServerSocket(8080) // in testval server = ServerSocket(0)
val port = server.localPortPortul 0 cere sistemului un port liber, ideal pentru teste care rulează în paralel.
Repară eroarea, direct în pagină
Programul pornește un al doilea server pe portul pe care ascultă deja primul și se oprește cu BindException: Address already in use. Eliberează portul închizând primul server înainte să-l pornești pe al doilea, ca programul să afișeze Pornit: true.
import java.net.ServerSocket
fun main() {
val primul = ServerSocket(0)
val port = primul.localPort
val alDoilea = ServerSocket(port)
println("Pornit pe portul ${alDoilea.localPort}")
}Pornit: true
Indiciu
Apelează primul.close() înainte de ServerSocket(port).
Reparația
import java.net.ServerSocket
fun main() {
val primul = ServerSocket(0)
val port = primul.localPort
primul.close()
val alDoilea = ServerSocket(port)
println("Pornit: ${alDoilea.localPort == port}")
}De ce merge
Un port poate fi ascultat de un singur server. Cât timp primul era deschis, sistemul a refuzat legarea celui de-al doilea pe același port. După primul.close(), portul e liber, iar alDoilea pornește pe el. În aplicații reale, aceasta e situația „oprește instanța veche înainte s-o pornești pe cea nouă”.
Alte forme ale mesajului
Exception in thread "main" java.net.BindException: Address already in usejava.net.BindException: Address already in use: bindjava.net.BindException: Address already in use: JVM_BindWeb server failed to start. Port 8080 was already in use.
Cum o eviți pe viitor
Citește portul din configurare (PORT din variabilele de mediu), cu o valoare implicită. În teste folosește portul 0. Oprește aplicația din IDE înainte s-o repornești sau activează „single instance only” la configurația de rulare. Închide serverele în finally sau use, ca să elibereze portul.
Întrebări frecvente
Am oprit aplicația și tot primesc eroarea
Probabil procesul încă rulează în fundal sau portul e folosit de alt program. Verifică cu lsof -i :PORT și oprește procesul găsit.
Ce e portul 0?
Nu e un port real: îi cere sistemului de operare să aleagă un port liber. Afli care a fost ales din server.localPort.
Erori înrudite
java.net.ConnectException: Connection refused Calculatorul la care te conectezi a răspuns, dar niciun program nu ascultă pe portul acela: serverul (API-ul, baza de date) nu e pornit, ascultă pe alt port sau doar pe altă interfață. Verifică portul și pornește serviciul înainte să te conectezi. java.net.SocketTimeoutException: Read timed out Conexiunea s-a deschis, dar serverul nu a trimis niciun răspuns în timpul permis (read timeout). Serverul e lent, blocat sau timeout-ul e prea mic. Mărește timeout-ul dacă e cazul și tratează excepția: reîncercare sau mesaj clar. java.util.concurrent.RejectedExecutionException: Task java.util.concurrent.FutureTask@4aa298b7 rejected from java.util.concurrent.ThreadPoolExecutor@7852e922[Terminated, pool size = 0, active threads = 0, queued tasks = 0, completed tasks = 0] Ai trimis o sarcină (submit / execute) unui ExecutorService care a fost deja oprit cu shutdown(), sau a cărui coadă e plină. Trimite toate sarcinile înainte de shutdown() și oprește executorul doar la final. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
