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.
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 (
8080față de8081,5432față de5433); - serverul ascultă doar pe
127.0.0.1, iar tu te conectezi din alt container sau de pe alt calculator; - în Docker,
localhostdin container nu este calculatorul tău (folosește numele serviciului sauhost.docker.internal); - în emulatorul Android,
localhosteste emulatorul (folosește10.0.2.2).
De ce apare: cauzele frecvente
1Server oprit
Socket("localhost", 8080)// porneste intai serverul, apoi:
Socket("localhost", 8080)Fără un program care ascultă pe port, sistemul refuză conexiunea.
2Port greșit în configurare
val db = "jdbc:postgresql://localhost:5433/magazin"val db = "jdbc:postgresql://localhost:5432/magazin"Portul din client trebuie să fie exact cel pe care ascultă serverul.
3localhost din container sau emulator
val api = "http://localhost:8080" // din emulatorul Androidval 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ă 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.
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") }
}Conectat
Indiciu
Mută server.close() după blocul în care clientul se conectează.
Reparația
import java.net.ServerSocket
import java.net.Socket
fun main() {
val server = ServerSocket(0)
val port = server.localPort
Socket("localhost", port).use { println("Conectat") }
server.close()
}De ce merge
După server.close(), niciun program nu mai ascultă pe acel port, deci sistemul de operare refuză imediat conexiunea clientului. Cât timp ServerSocket e deschis, sistemul acceptă conexiunea în coada serverului, chiar înainte de un accept() explicit, iar clientul se conectează. Închizi serverul la final, după ce ai terminat cu el.
Alte forme ale mesajului
Exception in thread "main" java.net.ConnectException: Connection refusedjava.net.ConnectException: Connection refused: connectjava.net.ConnectException: Failed to connect to localhost/127.0.0.1:8080org.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
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. 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.net.MalformedURLException: no protocol: example.com/api Ai creat un URL fără schemă la început (example.com/api în loc de https://example.com/api) sau cu un text gol. Clasa URL cere protocolul. Adaugă https:// (sau http://), iar dacă adresa vine din configurare, verific-o și curăț-o (trim) înainte. Î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.
