...
Eroare Spring Boot · Proiect, dependențe și migrarea la Boot 3

ApplicationContextException: Unable to start web server; nested exception is ApplicationContextException: Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean.

Pe scurt

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

Greșit
JAVA
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}
Corect
JAVA
@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

Greșit
JAVA
SpringApplication.run(ProdusController.class, args);
Corect
JAVA
SpringApplication.run(Application.class, args);

run trebuie să primească clasa cu @SpringBootApplication.

3Server exclus fără înlocuitor

Greșit
JAVA
<exclusion>
  <artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
Corect
JAVA
<dependency>
  <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

Dacă excluzi Tomcat, adaugă alt server.

Repară tu

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.

Codul care dă eroarea
JAVA
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";
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • Unable to start ServletWebServerApplicationContext due to missing ServletWebServerFactory bean
  • Web 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 @SpringBootApplication de pe ea.
  • Dă lui SpringApplication.run mereu 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

← 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.