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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru o aplicație web, Spring Boot creează un ServletWebServerApplicationContext, care are nevoie de un bean ServletWebServerFactory (Tomcat, Jetty sau Undertow) ca să pornească serverul. Acel bean vine din configurarea automată, activată de @SpringBootApplication (care include @EnableAutoConfiguration).
Dacă clasa transmisă lui SpringApplication.run(...) nu are adnotarea, nicio configurare automată nu rulează, nu există fabrica de server, iar pornirea eșuează cu Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean. Aceeași eroare apare când dai lui run altă clasă decât cea adnotată (de exemplu un controller), sau când în pom.xml lipsește spring-boot-starter-web, sau Tomcat a fost exclus fără să adaugi alt server.
Când nu e nevoie de server (aplicație de consolă), setezi spring.main.web-application-type=none.
De ce apare: cauzele frecvente
1Lipsește @SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}Adnotarea activează configurarea automată, care creează serverul Tomcat.
2Altă clasă dată lui run
SpringApplication.run(ProdusController.class, args);SpringApplication.run(Application.class, args);run trebuie să primească clasa cu @SpringBootApplication.
3Server exclus fără înlocuitor
<exclusion>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion><dependency>
<artifactId>spring-boot-starter-jetty</artifactId>
</dependency>Dacă excluzi Tomcat, adaugă alt server.
Repară eroarea, direct în pagină
Aplicația nu pornește: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean. Importul există, dar adnotarea de pe clasa principală a fost ștearsă din greșeală. Pune-o la loc, ca GET /salut să răspundă Salut din Spring Boot.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut din Spring Boot";
}
}Tomcat started on port 8080 (http) Started Application GET /salut → 200 Salut din Spring Boot
Indiciu
Clasa dată lui SpringApplication.run trebuie să aibă @SpringBootApplication.
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
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut din Spring Boot";
}
}De ce merge
Fără @SpringBootApplication, clasa Application era o clasă obișnuită: nicio configurare automată, nicio scanare de componente, deci nici fabrica de server Tomcat. Spring Boot nu avea cu ce porni serverul web. Cu adnotarea pusă la loc, configurarea automată creează serverul, scanarea găsește SalutController, iar ruta răspunde.
Alte forme ale mesajului
Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory beanWeb application could not be started as there was no org.springframework.boot.web.servlet.server.ServletWebServerFactory bean defined in the context.
Cum o eviți pe viitor
- Generează clasa principală cu start.spring.io și nu șterge
@SpringBootApplicationde pe ea. - Dă lui
SpringApplication.runmereu clasa principală. - Păstrează clasa principală în pachetul rădăcină, ca scanarea să găsească tot.
- Pentru aplicații fără web, setează explicit
spring.main.web-application-type=none.
Întrebări frecvente
Pot folosi @EnableAutoConfiguration în loc?
Da, dar @SpringBootApplication le combină pe @Configuration, @EnableAutoConfiguration și @ComponentScan, deci e varianta obișnuită.
Aplicația mea nu are nevoie de web. Ce fac?
Scoate spring-boot-starter-web sau setează spring.main.web-application-type=none.
Erori înrudite
Cannot resolve symbol 'SpringBootApplication' Compilatorul nu găsește adnotarea @SpringBootApplication: lipsește importul org.springframework.boot.autoconfigure.SpringBootApplication sau proiectul nu are dependențele Spring Boot (Maven/Gradle nu le-a descărcat). Adaugă importul și reîncarcă proiectul. 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. error: package javax.servlet.http does not exist În Spring Boot 3, API-ul Servlet este în jakarta.servlet, nu în javax.servlet. Înlocuiește importurile (HttpServletRequest, HttpServletResponse, Filter, Cookie) cu jakarta.servlet.*. Î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.
