Web server failed to start. Port 8080 was already in use.
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ă
# rulezi aplicația a doua oară din IDE,
# fără să o oprești pe primalsof -i :8080 # afli PID-ul
kill 12345 # oprești procesul vechiInstanța veche ține portul ocupat până o oprești.
2Două servicii pe același port
# catalog: server.port=8080
# stoc: server.port=8080# catalog: server.port=8080
# stoc: server.port=8081Fiecare serviciu are nevoie de portul lui.
3Ai nevoie de alt port doar local
java -jar app.jarjava -jar app.jar --server.port=8085Argumentul din linia de comandă suprascrie server.port fără să schimbi fișierele.
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ă.
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";
}
}
}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.
Reparația
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, "--server.port=8081");
}
@RestController
static class StocController {
@GetMapping("/stoc/1")
String stoc() {
return "12 bucăți";
}
}
}De ce merge
Ambele servicii foloseau portul implicit 8080, iar al doilea nu-l mai putea deschide. Argumentul --server.port=8081 are prioritate față de fișierele de configurare, deci StocApp pornește pe 8081. În proiecte reale fiecare serviciu are portul în propriul application.properties. Când eroarea apare cu o singură aplicație, aproape sigur rulează o instanță veche: o oprești, nu schimbi portul.
Alte forme ale mesajului
Address already in use: bindjava.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
Could not resolve placeholder 'app.magazin.nume' in value "${app.magazin.nume}" Un @Value("${cheie}") cere o proprietate care nu există în application.properties (sau în profilul activ, în variabilele de mediu). Adaugă proprietatea, corectează numele cheii sau pune o valoare implicită: ${cheie:valoare}. No active profile set, falling back to 1 default profile: "default" Mesajul INFO de la pornire spune că niciun profil nu e activ, deci Spring folosește doar application.properties și ignoră application-dev.properties. Nu e o eroare; dacă ai nevoie de un profil, activează-l cu spring.profiles.active=dev. ApplicationContextException: Unable to start web server; nested exception is ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean. Spring Boot nu poate porni serverul web pentru că lipsește configurarea automată: clasa dată lui SpringApplication.run nu are @SpringBootApplication (sau @EnableAutoConfiguration), ori lipsește spring-boot-starter-web. Pune adnotarea pe clasa principală. Î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.
