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

error: package javax.persistence does not exist

Pe scurt

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

Greșit
JAVA
import javax.persistence.Entity;
import javax.persistence.Id;
Corect
JAVA
import jakarta.persistence.Entity;
import jakarta.persistence.Id;

În Boot 3, JPA este în jakarta.persistence.

2Dependență explicită veche

Greșit
JAVA
<dependency>
  <groupId>javax.persistence</groupId>
  <artifactId>javax.persistence-api</artifactId>
</dependency>
Corect
JAVA
<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ă tu

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.

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.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();
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse/info → 200
Entitate: Produs
Indiciu

În Spring Boot 3, javax.persistence devine jakarta.persistence.

Alte forme ale mesajului

  • error: cannot find symbol: class Entity
  • Cannot 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.annotation cu jakarta.*.
  • 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

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