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

error: package javax.servlet.http does not exist

Pe scurt

Î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

Greșit
JAVA
import javax.servlet.http.HttpServletRequest;
Corect
JAVA
import jakarta.servlet.http.HttpServletRequest;

Servlet 6 este în jakarta.servlet.

2Bibliotecă incompatibilă cu Boot 3

Greșit
JAVA
<artifactId>springfox-boot-starter</artifactId>
Corect
JAVA
<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ă tu

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.

Codul care dă eroarea
JAVA
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();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /client → 200
GET /client
Indiciu

Pachetul Servlet din Spring Boot 3 începe cu jakarta.

Alte forme ale mesajului

  • java.lang.ClassNotFoundException: javax.servlet.Filter
  • java.lang.NoClassDefFoundError: javax/servlet/http/HttpServletRequest
  • Cannot resolve symbol 'servlet'

Cum o eviți pe viitor

  • Înlocuiește în tot proiectul javax.servlet cu jakarta.servlet când migrezi la Boot 3.
  • Verifică pentru fiecare bibliotecă din pom.xml dacă are o versiune pentru Jakarta EE.
  • Rulează mvn dependency:tree | grep javax ca să găsești dependențele care încă aduc API-uri vechi.
  • Preferă abstracțiile Spring (@RequestHeader, @CookieValue) în loc de HttpServletRequest, 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

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