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.*.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot 3 rulează pe Tomcat 10+ și Servlet 6, din Jakarta EE, unde pachetul javax.servlet a devenit jakarta.servlet. Orice cod care folosește direct API-ul Servlet (HttpServletRequest, HttpServletResponse, Filter, FilterChain, Cookie, HttpSession) trebuie să-l importe din jakarta.servlet și jakarta.servlet.http.
Compilatorul raportează întâi pachetul lipsă, apoi cannot find symbol pentru fiecare clasă. Mai rar, eroarea apare la rulare, ca ClassNotFoundException: javax.servlet.Filter sau NoClassDefFoundError: o bibliotecă compilată pentru Servlet 4 (de exemplu o versiune veche de Swagger, springfox sau un filtru propriu publicat ca JAR) este încă în proiect. Soluția atunci e versiunea compatibilă cu Jakarta a bibliotecii, de exemplu springdoc-openapi 2 în loc de springfox.
De ce apare: cauzele frecvente
1Import vechi în controller sau filtru
import javax.servlet.http.HttpServletRequest;import jakarta.servlet.http.HttpServletRequest;Servlet 6 este în jakarta.servlet.
2Bibliotecă incompatibilă cu Boot 3
<artifactId>springfox-boot-starter</artifactId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>springfox folosește javax.servlet și nu mai e întreținut; springdoc 2 e compatibil cu Boot 3.
Repară eroarea, direct în pagină
Controllerul citește adresa clientului din HttpServletRequest, dar nu compilează în Spring Boot 3: package javax.servlet.http does not exist. Corectează importul ca GET /client să răspundă cu metoda și ruta cererii: GET /client.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import javax.servlet.http.HttpServletRequest;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ClientController {
@GetMapping("/client")
String client(HttpServletRequest cerere) {
return cerere.getMethod() + " " + cerere.getRequestURI();
}
}Tomcat started on port 8080 (http) Started Application GET /client → 200 GET /client
Indiciu
Pachetul Servlet din Spring Boot 3 începe cu jakarta.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*;
import org.springframework.http.*;
import java.util.*;
import jakarta.servlet.http.HttpServletRequest;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ClientController {
@GetMapping("/client")
String client(HttpServletRequest cerere) {
return cerere.getMethod() + " " + cerere.getRequestURI();
}
}De ce merge
Spring Boot 3 folosește Servlet 6 din Jakarta EE, unde HttpServletRequest este în jakarta.servlet.http. Importul vechi nu mai găsea nimic, iar compilarea se oprea. Clasa și metodele ei (getMethod, getRequestURI) sunt identice, se schimbă doar pachetul, deci controllerul funcționează imediat după corectarea importului.
Alte forme ale mesajului
java.lang.ClassNotFoundException: javax.servlet.Filterjava.lang.NoClassDefFoundError: javax/servlet/http/HttpServletRequestCannot resolve symbol 'servlet'
Cum o eviți pe viitor
- Înlocuiește în tot proiectul
javax.servletcujakarta.servletcând migrezi la Boot 3. - Verifică pentru fiecare bibliotecă din
pom.xmldacă are o versiune pentru Jakarta EE. - Rulează
mvn dependency:tree | grep javaxca să găsești dependențele care încă aduc API-uri vechi. - Preferă abstracțiile Spring (
@RequestHeader,@CookieValue) în loc deHttpServletRequest, acolo unde se poate.
Întrebări frecvente
De ce compilează, dar crapă la pornire?
Codul tău e corect, dar un JAR din dependențe folosește încă javax.servlet. Caută-l cu mvn dependency:tree și actualizează-l.
Tomcat 9 merge cu Boot 3?
Nu. Boot 3 cere Servlet 6, deci Tomcat 10.1 sau mai nou.
Erori înrudite
error: package javax.persistence does not exist Proiectul folosește Spring Boot 3 (Jakarta EE), unde adnotările JPA s-au mutat din javax.persistence în jakarta.persistence. Schimbă importurile din javax.persistence.* în jakarta.persistence.*; restul codului rămâne la fel. package jakarta.validation does not exist Proiectul nu are dependența de validare: de la Spring Boot 2.3, ea nu mai vine cu spring-boot-starter-web. Adaugă spring-boot-starter-validation în pom.xml (sau build.gradle), apoi reîncarcă proiectul. 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.
