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.
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ă
go run . # în terminalul 1, încă rulează
go run . # în terminalul 2 -> address already in uselsof -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
go http.ListenAndServe(":8080", api)
http.ListenAndServe(":8080", admin)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
l, err := net.Listen("tcp", ":8080")l, err := net.Listen("tcp", "127.0.0.1:0")
fmt.Println(l.Addr()) // portul ales de sistemCu portul 0, sistemul alege un port liber; în teste folosește și httptest.NewServer.
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.
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())
}Porturi diferite: true
Indiciu
Cu adresa 127.0.0.1:0, sistemul de operare alege automat un port liber.
Reparația
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", "127.0.0.1:0")
if err != nil {
log.Fatal(err)
}
defer admin.Close()
fmt.Println("Porturi diferite:", api.Addr().String() != admin.Addr().String())
}De ce merge
Un port poate fi ascultat de un singur socket deodată. Serverul de administrare cerea exact adresa (și portul) pe care asculta deja serverul API, așa că bind a eșuat. Cu 127.0.0.1:0, sistemul de operare alege pentru fiecare server un port liber diferit, iar comparația adreselor confirmă că sunt diferite.
Alte forme ale mesajului
listen tcp 127.0.0.1:8080: bind: address already in uselisten 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
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. 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. open config.json: no such file or directory Fișierul pe care încerci să-l deschizi nu există la calea dată, de cele mai multe ori pentru că o cale relativă e căutată în folderul din care rulezi programul, nu lângă fișierul .go. Verifică directorul curent și calea, iar pentru fișiere opționale tratează errors.Is(err, fs.ErrNotExist). Î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.
