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

java.net.ConnectException: Connection refused

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Connection refused înseamnă că pachetul a ajuns la mașina țintă, dar sistemul de operare a răspuns că nu există niciun program care să accepte conexiuni pe portul cerut. E diferit de un timeout (Connection timed out), unde nu vine niciun răspuns, și de UnknownHostException, unde numele nu poate fi rezolvat.

Cauze reale la un junior:

  • serverul local (Spring, Ktor, PostgreSQL, Docker) nu e pornit sau a căzut la pornire;
  • port greșit în configurare (8080 față de 8081, 5432 față de 5433);
  • serverul ascultă doar pe 127.0.0.1, iar tu te conectezi din alt container sau de pe alt calculator;
  • în Docker, localhost din container nu este calculatorul tău (folosește numele serviciului sau host.docker.internal);
  • în emulatorul Android, localhost este emulatorul (folosește 10.0.2.2).

De ce apare: cauzele frecvente

1Server oprit

Greșit
KOTLIN
Socket("localhost", 8080)
Corect
KOTLIN
// porneste intai serverul, apoi:
Socket("localhost", 8080)

Fără un program care ascultă pe port, sistemul refuză conexiunea.

2Port greșit în configurare

Greșit
KOTLIN
val db = "jdbc:postgresql://localhost:5433/magazin"
Corect
KOTLIN
val db = "jdbc:postgresql://localhost:5432/magazin"

Portul din client trebuie să fie exact cel pe care ascultă serverul.

3localhost din container sau emulator

Greșit
KOTLIN
val api = "http://localhost:8080"  // din emulatorul Android
Corect
KOTLIN
val api = "http://10.0.2.2:8080"  // calculatorul gazda vazut din emulator

În emulator sau container, localhost e chiar mașina virtuală, nu calculatorul tău.

Repară tu

Repară eroarea, direct în pagină

Programul pornește un server pe un port liber, dar îl oprește înainte să se conecteze clientul, așa că se oprește cu ConnectException: Connection refused. Închide serverul abia după ce clientul s-a conectat, ca programul să afișeze Conectat.

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

fun main() {
    val server = ServerSocket(0)
    val port = server.localPort
    server.close()
    Socket("localhost", port).use { println("Conectat") }
}
După reparație, programul afișează
Conectat
Indiciu

Mută server.close() după blocul în care clientul se conectează.

Alte forme ale mesajului

  • Exception in thread "main" java.net.ConnectException: Connection refused
  • java.net.ConnectException: Connection refused: connect
  • java.net.ConnectException: Failed to connect to localhost/127.0.0.1:8080
  • org.postgresql.util.PSQLException: Connection to localhost:5432 refused

Cum o eviți pe viitor

Ține host-ul și portul în configurare (variabile de mediu, application.yml), nu scrise în cod. Când pornești local, verifică întâi că serverul ascultă (lsof -i :8080 pe macOS/Linux, netstat -ano pe Windows). În cod, prinde ConnectException acolo unde ai o alternativă (reîncercare cu pauză, mesaj clar pentru utilizator).

Întrebări frecvente

Care e diferența față de timeout?

La Connection refused mașina răspunde imediat că portul e închis. La timeout nu răspunde nimic, de obicei din cauza unui firewall sau a unei adrese greșite.

De ce merge din browser și nu din aplicație?

De obicei aplicația rulează în alt loc (container, emulator) unde localhost înseamnă altceva, sau folosește alt port decât cel din browser.

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.