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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot 3 și Spring Framework 6 au trecut de la Java EE la Jakarta EE 9+, unde toate pachetele javax.* ale specificațiilor (JPA, Servlet, Bean Validation, Transactions) au fost redenumite în jakarta.*. Hibernate 6, inclus în Boot 3, aduce doar jakarta.persistence, așa că un import javax.persistence.Entity nu mai are ce găsi, iar compilatorul spune package javax.persistence does not exist, urmat de cannot find symbol pentru fiecare @Entity, @Id, @Column.
Eroarea apare aproape mereu în trei situații: ai copiat cod dintr-un tutorial pentru Spring Boot 2, ai migrat un proiect vechi la Boot 3 sau ai adăugat o bibliotecă veche care încă folosește javax.
Atenție: nu toate pachetele javax s-au mutat. javax.sql.DataSource, javax.crypto sau javax.net fac parte din JDK și rămân neschimbate.
De ce apare: cauzele frecvente
1Cod scris pentru Spring Boot 2
import javax.persistence.Entity;
import javax.persistence.Id;import jakarta.persistence.Entity;
import jakarta.persistence.Id;În Boot 3, JPA este în jakarta.persistence.
2Dependență explicită veche
<dependency>
<groupId>javax.persistence</groupId>
<artifactId>javax.persistence-api</artifactId>
</dependency><dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>Starter-ul aduce versiunea Jakarta potrivită, gestionată de Spring Boot.
Repară eroarea, direct în pagină
Clasa Produs a fost copiată dintr-un proiect Spring Boot 2 și nu compilează: package javax.persistence does not exist. Schimbă importul ca entitatea să folosească pachetul JPA din Spring Boot 3, fără să modifici adnotările, iar GET /produse/info să răspundă Entitate: Produs.
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.persistence.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
Long id;
String nume;
}
@RestController
class InfoController {
@GetMapping("/produse/info")
String info() {
return "Entitate: " + Produs.class.getSimpleName();
}
}Tomcat started on port 8080 (http) Started Application GET /produse/info → 200 Entitate: Produs
Indiciu
În Spring Boot 3, javax.persistence devine jakarta.persistence.
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.persistence.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Entity
class Produs {
@Id
@GeneratedValue
Long id;
String nume;
}
@RestController
class InfoController {
@GetMapping("/produse/info")
String info() {
return "Entitate: " + Produs.class.getSimpleName();
}
}De ce merge
Spring Boot 3 vine cu Hibernate 6 și API-ul JPA din Jakarta EE, în pachetul jakarta.persistence. Vechiul javax.persistence nu mai există pe classpath, deci compilarea eșua la import și la fiecare adnotare. Schimbând doar pachetul, @Entity, @Id și @GeneratedValue sunt găsite, iar aplicația pornește. La migrări mari, OpenRewrite face această înlocuire în tot proiectul.
Alte forme ale mesajului
error: cannot find symbol: class EntityCannot resolve symbol 'persistence'import javax.persistence.*;
Cum o eviți pe viitor
- La migrarea la Spring Boot 3, înlocuiește toate importurile
javax.persistence,javax.servlet,javax.validation,javax.annotationcujakarta.*. - Folosește OpenRewrite (rețeta
UpgradeSpringBoot_3_0) sau funcția de migrare a IntelliJ, care fac înlocuirea automat. - Verifică versiunea de Spring Boot a unui tutorial înainte să copiezi cod din el.
- Nu declara manual versiuni pentru API-urile Jakarta: lasă starter-ele să le aleagă.
Întrebări frecvente
Pot rămâne pe javax?
Doar dacă rămâi pe Spring Boot 2.7, care nu mai primește actualizări gratuite. Pentru Boot 3 trebuie jakarta.
Se schimbă și adnotările?
Nu. Numele claselor și comportamentul sunt aceleași; se schimbă doar pachetul.
Erori înrudite
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.*. package javax.validation.constraints does not exist În Spring Boot 3, adnotările de validare sunt în pachetul jakarta.validation, nu javax.validation. Înlocuiește importurile javax.validation.* cu jakarta.validation.* (și verifică dependența spring-boot-starter-validation). 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. Î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.
