...
Eroare Go · HTTP și URL-uri

listen tcp: address 8080: missing port in address

Pe scurt

Adresa dată lui http.ListenAndServe sau net.Listen trebuie să aibă forma host:port, iar tu ai dat doar numărul portului. Pune două puncte în față: ":8080" (toate interfețele) sau "127.0.0.1:8080" (doar local).

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

Ce înseamnă

Funcțiile de rețea din Go primesc adresa ca un singur string host:port. Partea de host poate lipsi (:8080 înseamnă „pe toate interfețele”), dar cele două puncte și portul sunt obligatorii. Cu "8080", Go nu are cum să știe că e un port și nu un nume de host, așa că se oprește înainte să deschidă ceva: listen tcp: address 8080: missing port in address.

Apare de obicei când portul vine din configurare sau dintr-o variabilă de mediu (PORT=8080 pe platformele de hosting) și e dat direct funcției. La client mesajul are forma dial tcp: address localhost: missing port in address.

Înrudit: too many colons in address pentru o adresă IPv6 fără paranteze pătrate. Corect este [::1]:8080; net.JoinHostPort pune parantezele singur.

De ce apare: cauzele frecvente

1Portul din variabila de mediu

Greșit
GO
port := os.Getenv("PORT") // "8080"
log.Fatal(http.ListenAndServe(port, nil))
Corect
GO
port := os.Getenv("PORT")
if port == "" {
	port = "8080"
}
log.Fatal(http.ListenAndServe(":"+port, nil))

":"+port dă adresa :8080; valoarea implicită acoperă variabila lipsă.

2Host și port din câmpuri separate

Greșit
GO
adresa := cfg.Host + cfg.Port
// "localhost8080"
Corect
GO
adresa := net.JoinHostPort(cfg.Host, cfg.Port)
// "localhost:8080"

net.JoinHostPort pune separatorul corect, inclusiv parantezele pentru IPv6.

Repară tu

Repară eroarea, direct în pagină

Serverul citește portul din configurare ("18080") și îl dă direct lui net.Listen, care se oprește cu listen tcp: address 18080: missing port in address. Construiește adresa locală completă cu net.JoinHostPort, ca programul să afișeze:

Server pornit pe 127.0.0.1:18080
Codul care dă eroarea
GO
package main

import (
	"fmt"
	"log"
	"net"
)

func main() {
	port := "18080" // din configurare
	ln, err := net.Listen("tcp", port)
	if err != nil {
		log.Fatal(err)
	}
	defer ln.Close()
	fmt.Println("Server pornit pe", ln.Addr())
}
După reparație, programul afișează
Server pornit pe 127.0.0.1:18080
Indiciu

adresa := net.JoinHostPort("127.0.0.1", port).

Alte forme ale mesajului

  • dial tcp: address localhost: missing port in address
  • address 8080: missing port in address
  • listen tcp: address ::1:8080: too many colons in address

Cum o eviți pe viitor

Păstrează în configurare adresa completă (ADDR=:8080) sau construiește-o mereu cu net.JoinHostPort. Validează adresa la pornire cu net.SplitHostPort și oprește programul cu un mesaj clar dacă e invalidă. Loghează adresa pe care pornește serverul, ca să vezi imediat ce valoare a primit.

Întrebări frecvente

Care e diferența dintre :8080 și 127.0.0.1:8080?

:8080 ascultă pe toate interfețele, deci serverul e accesibil și din rețea (sau din afara unui container). 127.0.0.1:8080 ascultă doar local, pe calculatorul tău.

Ce face portul 0?

:0 cere sistemului un port liber oarecare. E util în teste; portul primit îl afli cu ln.Addr().

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.