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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot 3 (și Spring Framework 6) a trecut de la Java EE la Jakarta EE 9+, iar pachetele s-au redenumit din javax.* în jakarta.*. Pentru validare: javax.validation.constraints.NotBlank devine jakarta.validation.constraints.NotBlank, javax.validation.Valid devine jakarta.validation.Valid.
Codul scris pentru Spring Boot 2 (tutoriale, proiecte vechi, răspunsuri copiate de pe internet) nu mai compilează: javac spune package javax.validation.constraints does not exist, apoi cannot find symbol pentru fiecare adnotare folosită.
Uneori pachetul javax.validation există totuși în proiect (adus de o bibliotecă veche), codul compilează, dar adnotările sunt ignorate: Spring Boot 3 caută doar jakarta.validation. E și mai periculos, pentru că validarea „nu merge” fără nicio eroare. Reparația e aceeași: importuri jakarta.
De ce apare: cauzele frecvente
1Import vechi, din Spring Boot 2
import javax.validation.Valid;
import javax.validation.constraints.NotBlank;import jakarta.validation.Valid;
import jakarta.validation.constraints.NotBlank;În Boot 3, API-ul de validare e în pachetul jakarta.
2Dependență veche în pom.xml
<artifactId>validation-api</artifactId>
<groupId>javax.validation</groupId><groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>Starter-ul aduce versiunea Jakarta potrivită cu Boot 3.
Repară eroarea, direct în pagină
Codul a fost copiat dintr-un tutorial pentru Spring Boot 2 și nu compilează: package javax.validation.constraints does not exist. Actualizează importurile pentru Spring Boot 3, ca validarea să funcționeze: numele gol primește 400, iar Ana primește Salut, Ana!.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;
import javax.validation.constraints.NotBlank;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Salut(@NotBlank String nume) {
}
@RestController
class SalutController {
@PostMapping("/salut")
String salut(@Valid @RequestBody Salut s) {
return "Salut, " + s.nume() + "!";
}
}Tomcat started on port 8080 (http)
Started Application
POST /salut → 400
{"status":400,"error":"Bad Request","path":"/salut"}
POST /salut → 200
Salut, Ana!Indiciu
În Spring Boot 3 pachetul începe cu jakarta.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import jakarta.validation.Valid;
import jakarta.validation.constraints.NotBlank;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Salut(@NotBlank String nume) {
}
@RestController
class SalutController {
@PostMapping("/salut")
String salut(@Valid @RequestBody Salut s) {
return "Salut, " + s.nume() + "!";
}
}De ce merge
Spring Boot 3 folosește Jakarta EE, unde API-ul de validare se numește jakarta.validation. Importurile javax.validation nu mai există, de unde eroarea de compilare. Cu importurile jakarta, adnotările sunt recunoscute, iar @Valid respinge numele gol cu 400. Restul codului rămâne identic: s-a schimbat doar numele pachetului.
Alte forme ale mesajului
package javax.validation does not existerror: cannot find symbol @NotBlank
Cum o eviți pe viitor
- Când copiezi cod Spring de pe internet, verifică versiunea:
javaxînseamnă Boot 2. - La migrare, folosește înlocuirea automată
javax.→jakarta.(OpenRewrite are rețete pentru Boot 3). - Atenție: nu toate pachetele
javaxse mută.javax.sqlșijavax.cryptorămân în JDK. - Elimină din
pom.xmldependențelejavax.validationrămase.
Întrebări frecvente
Toate importurile javax devin jakarta?
Nu. Se schimbă cele din Java EE (validation, persistence, servlet, annotation, transaction). Cele din JDK (javax.sql, javax.crypto, javax.net) rămân.
De ce compila, dar validarea nu funcționa?
Probabil ai și javax.validation în proiect, adus de o dependență. Spring Boot 3 nu-l folosește, deci adnotările sunt ignorate.
Erori înrudite
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. 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. MethodArgumentNotValidException: Validation failed for argument [0] in public java.lang.String ClientController.inregistreaza(ClientNou): [Field error in object 'clientNou' on field 'email': rejected value [ana]; default message [must be a well-formed email address]] Corpul primit cu @Valid a încălcat regulile de validare (@NotBlank, @Email, @Min...), iar Spring răspunde 400. Mesajul listează câmpul, valoarea respinsă și motivul. Tratează excepția într-un @RestControllerAdvice ca clientul să primească erorile pe câmpuri. Î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.
