...
Eroare Spring Boot · Configurare, proprietăți și profiluri

Web server failed to start. Port 8080 was already in use.

Pe scurt

Alt proces ascultă deja pe portul 8080 (adesea o instanță mai veche a aceleiași aplicații sau alt serviciu), deci Tomcat nu poate porni. Oprește procesul vechi sau pornește aplicația pe alt port cu server.port=8081.

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

Ce înseamnă

La pornire, Tomcat-ul încorporat încearcă să deschidă portul din server.port (implicit 8080). Pe un calculator, un port poate fi ocupat de un singur proces. Dacă e deja luat, Spring Boot afișează:

Web server failed to start. Port 8080 was already in use.

Action:

Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.

Cel mai des, procesul care ocupă portul este chiar aplicația ta, pornită anterior și rămasă în fundal (o rulare din IDE neoprită, un terminal uitat). Alteori e un alt program (un alt serviciu Java, un server de dezvoltare, un container Docker) sau, în proiectele cu mai multe microservicii, două servicii configurate pe același port.

Pe Linux/macOS afli procesul cu lsof -i :8080, pe Windows cu netstat -ano | findstr :8080.

De ce apare: cauzele frecvente

1O instanță veche rulează încă

Greșit
JAVA
# rulezi aplicația a doua oară din IDE,
# fără să o oprești pe prima
Corect
JAVA
lsof -i :8080        # afli PID-ul
kill 12345           # oprești procesul vechi

Instanța veche ține portul ocupat până o oprești.

2Două servicii pe același port

Greșit
JAVA
# catalog: server.port=8080
# stoc:    server.port=8080
Corect
JAVA
# catalog: server.port=8080
# stoc:    server.port=8081

Fiecare serviciu are nevoie de portul lui.

3Ai nevoie de alt port doar local

Greșit
JAVA
java -jar app.jar
Corect
JAVA
java -jar app.jar --server.port=8085

Argumentul din linia de comandă suprascrie server.port fără să schimbi fișierele.

Repară tu

Repară eroarea, direct în pagină

Fișierul pornește două servicii, Application (catalogul) și StocApp, dar al doilea se oprește: Port 8080 was already in use. Pornește StocApp pe portul 8081, transmițând argumentul --server.port=8081 la SpringApplication.run, ca ambele rute să răspundă.

Codul care dă eroarea
JAVA
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @RestController
    static class CatalogController {
        @GetMapping("/produse/1")
        String produs() {
            return "Mouse";
        }
    }
}

@SpringBootApplication
class StocApp {
    public static void main(String[] args) {
        SpringApplication.run(StocApp.class, args);
    }

    @RestController
    static class StocController {
        @GetMapping("/stoc/1")
        String stoc() {
            return "12 bucăți";
        }
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
Tomcat started on port 8081 (http)
Started StocApp
GET /produse/1 → 200
Mouse
GET http://localhost:8081/stoc/1 → 200
12 bucăți
Indiciu

SpringApplication.run primește după clasă și argumentele din linia de comandă, ca texte.

Alte forme ale mesajului

  • Address already in use: bind
  • java.net.BindException: Address already in use

Cum o eviți pe viitor

  • Oprește aplicația din IDE înainte s-o pornești din nou (sau activează „single instance only” în configurarea de rulare).
  • Dă fiecărui microserviciu un port fix, documentat în application.properties.
  • Pentru teste de integrare, folosește webEnvironment = RANDOM_PORT, ca testele să nu se lovească de aplicația care rulează.

Întrebări frecvente

Pot alege un port liber automat?

Da, server.port=0 alege un port liber la fiecare pornire. E util în teste, mai puțin în dezvoltare, unde vrei o adresă stabilă.

De ce apare doar uneori?

Pentru că depinde de ce mai rulează pe calculator în acel moment, de obicei o instanță uitată a aplicației.

Erori înrudite

← Toate erorile Spring Boot

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ță Spring Boot de la zero, cu exerciții la fiecare lecție

Curs Spring Boot și REST API: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 18 lecții sunt gratuite.