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

listen tcp :8080: bind: address already in use

Pe scurt

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.

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

Ce înseamnă

Mesajul vine de la net.Listen sau http.ListenAndServe și se citește pe bucăți: listen tcp :8080 este operația (ascultare TCP pe portul 8080, pe toate interfețele), bind este apelul de sistem care a eșuat, iar address already in use este motivul: alt socket ține deja acel port. Pe Windows, același caz arată ca bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.

Cauze tipice: programul rulează deja într-un alt terminal sau a rămas pornit în fundal de la go run anterior, alt serviciu folosește portul (alt server web, un container Docker), sau în același program pornești două servere pe același port.

Pe Linux și macOS afli cine ține portul cu lsof -i :8080 (sau ss -ltnp | grep 8080), pe Windows cu netstat -ano | findstr :8080.

De ce apare: cauzele frecvente

1Instanță veche încă pornită

Greșit
GO
go run .   # în terminalul 1, încă rulează
go run .   # în terminalul 2 -> address already in use
Corect
GO
lsof -i :8080   # afli PID-ul
kill <PID>      # oprești instanța veche
go run .

Doar un singur proces poate asculta pe un port. Oprește-l pe cel vechi (Ctrl+C în terminalul lui sau kill).

2Două servere pe același port în același program

Greșit
GO
go http.ListenAndServe(":8080", api)
http.ListenAndServe(":8080", admin)
Corect
GO
go http.ListenAndServe(":8080", api)
http.ListenAndServe(":8081", admin)

Fiecare server are nevoie de portul lui (sau combini handlerele într-un singur ServeMux).

3Port fix în teste

Greșit
GO
l, err := net.Listen("tcp", ":8080")
Corect
GO
l, err := net.Listen("tcp", "127.0.0.1:0")
fmt.Println(l.Addr()) // portul ales de sistem

Cu portul 0, sistemul alege un port liber; în teste folosește și httptest.NewServer.

Repară tu

Repară eroarea, direct în pagină

Programul pornește un server pentru API și unul pentru administrare, dar al doilea încearcă să asculte pe aceeași adresă ca primul și pornirea eșuează cu listen tcp 127.0.0.1:...: bind: address already in use. Pornește serverul de administrare pe un port liber ales de sistem (portul 0) ca programul să afișeze Porturi diferite: true.

Codul care dă eroarea
GO
package main

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

func main() {
	api, err := net.Listen("tcp", "127.0.0.1:0")
	if err != nil {
		log.Fatal(err)
	}
	defer api.Close()

	admin, err := net.Listen("tcp", api.Addr().String())
	if err != nil {
		log.Fatal(err)
	}
	defer admin.Close()

	fmt.Println("Porturi diferite:", api.Addr().String() != admin.Addr().String())
}
După reparație, programul afișează
Porturi diferite: true
Indiciu

Cu adresa 127.0.0.1:0, sistemul de operare alege automat un port liber.

Alte forme ale mesajului

  • listen tcp 127.0.0.1:8080: bind: address already in use
  • listen tcp :8080: bind: Only one usage of each socket address (protocol/network address/port) is normally permitted.
  • listen tcp :80: bind: permission denied

Cum o eviți pe viitor

Citește portul din configurare (PORT din variabilele de mediu) cu o valoare implicită, ca să-l poți schimba fără să modifici codul. Oprește serverul curat (cu srv.Shutdown(ctx) la Ctrl+C) ca să nu rămână procese agățate. În teste folosește httptest.NewServer sau portul 0. Dacă vezi bind: permission denied pe un port sub 1024, folosește un port mai mare (8080) în dezvoltare.

Întrebări frecvente

Am oprit programul, dar portul tot pare ocupat

Fie procesul încă rulează în fundal (verifică cu lsof -i :8080), fie un editor a pornit o sesiune de debug care nu s-a închis. Uneori, după oprire, conexiunile rămân câteva secunde în starea TIME_WAIT; serverele HTTP din Go pot reporni de obicei imediat, dar un proces rămas pornit trebuie oprit.

Ce înseamnă :8080 fără adresă?

Ascultare pe toate interfețele de rețea ale mașinii. 127.0.0.1:8080 ascultă doar local, ceea ce e mai sigur în dezvoltare.

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.