...
Eroare Go · Fișiere, timp și rețea

dial tcp 127.0.0.1:8080: connect: connection refused

Pe scurt

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

Greșit
GO
conn, err := net.Dial("tcp", "localhost:8080")
// serverul ascultă de fapt pe 8081
Corect
GO
conn, 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

Greșit
GO
DATABASE_URL=postgres://app@localhost:5432/magazin
Corect
GO
DATABASE_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

Greșit
GO
l, _ := net.Listen("tcp", "127.0.0.1:0")
adresa := l.Addr().String()
l.Close()
net.Dial("tcp", adresa)
Corect
GO
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ă tu

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.

Codul care dă eroarea
GO
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)
}
După reparație, programul afișează
Conectat la server: true
Indiciu

Închide serverul cu defer, nu imediat după Listen.

Alte forme ale mesajului

  • Get "http://localhost:8080/api": dial tcp [::1]:8080: connect: connection refused
  • dial 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

← Toate erorile Go

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ță 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.