dial tcp 127.0.0.1:8080: connect: connection refused
Pe adresa și portul la care te conectezi nu ascultă niciun server. Verifică dacă serverul (aplicația, baza de date, containerul) chiar rulează, pe ce port ascultă și dacă te conectezi la hostul corect; în Docker, localhost din container nu e mașina ta.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la net.Dial, de la clientul HTTP sau de la un driver de bază de date și se citește așa: dial tcp 127.0.0.1:8080 este încercarea de conectare TCP la acea adresă, connect este apelul de sistem, iar connection refused înseamnă că mașina a răspuns imediat că pe portul respectiv nu ascultă nimic. Prin clientul HTTP arată ca Get "http://localhost:8080/api": dial tcp [::1]:8080: connect: connection refused. Pe Windows: connectex: No connection could be made because the target machine actively refused it.
E diferit de un timeout: „refused” vine instant, deci hostul există și e accesibil, doar că serviciul nu e pornit pe acel port.
Cauze frecvente: serverul nu a pornit (sau a căzut la pornire), port greșit, serverul ascultă doar pe 127.0.0.1 dar tu te conectezi din alt container, sau clientul pornește înaintea serverului (de exemplu baza de date în docker compose).
De ce apare: cauzele frecvente
1Serverul nu e pornit sau portul e greșit
conn, err := net.Dial("tcp", "localhost:8080")
// serverul ascultă de fapt pe 8081conn, err := net.Dial("tcp", "localhost:8081")Portul clientului trebuie să fie cel pe care ascultă serverul. Verifică cu lsof -i :8081 sau în logurile serverului.
2localhost din interiorul unui container
DATABASE_URL=postgres://app@localhost:5432/magazinDATABASE_URL=postgres://app@db:5432/magazinÎn Docker, localhost este containerul însuși. Te conectezi la alt serviciu prin numele lui din docker-compose.yml.
3Serverul închis prea devreme
l, _ := net.Listen("tcp", "127.0.0.1:0")
adresa := l.Addr().String()
l.Close()
net.Dial("tcp", adresa)l, _ := net.Listen("tcp", "127.0.0.1:0")
defer l.Close()
adresa := l.Addr().String()
net.Dial("tcp", adresa)După Close, nimeni nu mai ascultă pe port, deci conexiunea e refuzată. Cu defer, serverul rămâne deschis până la final.
Repară eroarea, direct în pagină
Programul pornește un server de test și se conectează la el, dar serverul e închis imediat după pornire, așa că conectarea eșuează cu dial tcp 127.0.0.1:...: connect: connection refused. Ține serverul deschis până la final ca programul să afișeze Conectat la server: true.
package main
import (
"fmt"
"log"
"net"
)
func main() {
server, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
log.Fatal(err)
}
adresa := server.Addr().String()
server.Close()
conn, err := net.Dial("tcp", adresa)
if err != nil {
log.Fatal(err)
}
defer conn.Close()
fmt.Println("Conectat la server:", conn != nil)
}Conectat la server: true
Indiciu
Închide serverul cu defer, nu imediat după Listen.
Reparația
package main
import (
"fmt"
"log"
"net"
)
func main() {
server, err := net.Listen("tcp", "127.0.0.1:0")
if err != nil {
log.Fatal(err)
}
defer server.Close()
adresa := server.Addr().String()
conn, err := net.Dial("tcp", adresa)
if err != nil {
log.Fatal(err)
}
defer conn.Close()
fmt.Println("Conectat la server:", conn != nil)
}De ce merge
După server.Close(), pe port nu mai asculta nimeni, așa că sistemul de operare a refuzat imediat conexiunea. Cu defer server.Close(), serverul rămâne deschis până la ieșirea din main. Sistemul acceptă conexiunea TCP chiar înainte ca serverul să apeleze Accept, deci Dial reușește.
Alte forme ale mesajului
Get "http://localhost:8080/api": dial tcp [::1]:8080: connect: connection refuseddial tcp 127.0.0.1:5432: connectex: No connection could be made because the target machine actively refused it.dial tcp 127.0.0.1:6379: connect: connection refused
Cum o eviți pe viitor
Verifică întâi serviciul, nu codul: rulează, ascultă pe portul corect (lsof -i :PORT, docker ps)? Ține adresele în configurare, nu în cod. Când aplicația depinde de un serviciu care pornește mai greu (bază de date, broker), reîncearcă conexiunea de câteva ori cu pauze crescătoare la pornire și folosește healthcheck și depends_on în Docker Compose.
Întrebări frecvente
Care e diferența dintre connection refused și i/o timeout?
connection refused vine imediat: hostul e accesibil, dar portul e închis. i/o timeout înseamnă că nu a venit niciun răspuns (host oprit, firewall care aruncă pachetele, adresă greșită).
De ce apare [::1] în loc de 127.0.0.1?
localhost poate fi rezolvat și ca adresă IPv6 (::1). Dacă serverul ascultă doar pe 127.0.0.1, conectarea pe IPv6 e refuzată; folosește explicit 127.0.0.1 sau fă serverul să asculte pe ambele.
Erori înrudite
listen tcp :8080: bind: address already in use Portul pe care vrei să pornești serverul e deja ocupat: de o instanță veche a programului tău, de alt server sau de un al doilea Listen pe același port în același program. Oprește procesul care ține portul (lsof -i :8080) sau alege alt port. Get "localhost:8080/api": unsupported protocol scheme "localhost" URL-ul dat clientului HTTP nu începe cu http:// sau https://. Fără schemă, Go interpretează "localhost:" ca schemă (sau găsește o schemă goală) și refuză cererea. Adaugă http:// în fața adresei. context deadline exceeded Operația a durat mai mult decât termenul (timeout) al contextului, iar contextul a fost anulat. Verifică dacă timeout-ul e realist pentru operație, dacă serviciul apelat răspunde lent și tratează eroarea (reîncercare, mesaj clar), în loc să oprești programul. Învață Go de la zero, cu exerciții la fiecare lecție
Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
