...
Eroare Kotlin · Fișiere, rețea și fire de execuție

java.net.BindException: Address already in use

Pe scurt

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 (8080 e 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ă

Greșit
KOTLIN
embeddedServer(Netty, port = 8080) { }.start(wait = true)
Corect
KOTLIN
// 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

Greșit
KOTLIN
val api = ServerSocket(9000)
val admin = ServerSocket(9000)
Corect
KOTLIN
val api = ServerSocket(9000)
val admin = ServerSocket(9001)

Fiecare server are nevoie de portul lui.

3Port fix în teste

Greșit
KOTLIN
val server = ServerSocket(8080)  // in test
Corect
KOTLIN
val server = ServerSocket(0)
val port = server.localPort

Portul 0 cere sistemului un port liber, ideal pentru teste care rulează în paralel.

Repară tu

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.

Codul care dă eroarea
KOTLIN
import java.net.ServerSocket

fun main() {
    val primul = ServerSocket(0)
    val port = primul.localPort
    val alDoilea = ServerSocket(port)
    println("Pornit pe portul ${alDoilea.localPort}")
}
După reparație, programul afișează
Pornit: true
Indiciu

Apelează primul.close() înainte de ServerSocket(port).

Alte forme ale mesajului

  • Exception in thread "main" java.net.BindException: Address already in use
  • java.net.BindException: Address already in use: bind
  • java.net.BindException: Address already in use: JVM_Bind
  • Web 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

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.