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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Până la Spring Boot 2.2, validarea venea automat cu starter-ul web. De la 2.3 a fost scoasă într-un starter separat, spring-boot-starter-validation. Dacă proiectul nu îl are, pachetul jakarta.validation nu există pe classpath și javac raportează package jakarta.validation does not exist (sau package jakarta.validation.constraints does not exist), urmat de cannot find symbol pentru @Valid, @NotBlank etc.
Apare des în proiecte generate cu Spring Initializr fără bifa „Validation” sau când adaugi validarea mai târziu. În IntelliJ vezi importurile cu roșu și mesajul Cannot resolve symbol 'validation'.
O variantă înrudită: ai importul corect și dependența, dar ai uitat importul în fișier; atunci mesajul e cannot find symbol: class Valid.
De ce apare: cauzele frecvente
1Lipsește starter-ul de validare
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency><dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>Starter-ul aduce API-ul Jakarta Validation și Hibernate Validator.
2Dependența e adăugată, dar proiectul nu e reîncărcat
// pom.xml modificat, IDE-ul încă arată roșu./mvnw compile
// sau Reload All Maven Projects în IntelliJIDE-ul trebuie să descarce dependența și să actualizeze classpath-ul.
3Adnotare folosită fără import
record Salut(@NotBlank String nume) { } // fără importimport jakarta.validation.constraints.NotBlank;Fiecare adnotare trebuie importată din pachetul ei.
Repară eroarea, direct în pagină
Codul folosește @Valid și @NotBlank, dar nu compilează: adnotările nu sunt importate (într-un proiect fără spring-boot-starter-validation ai vedea package jakarta.validation does not exist). Adaugă importurile din jakarta.validation, ca numele gol să primească 400, iar Ana să primească Salut, Ana!.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
@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
Ai nevoie de jakarta.validation.Valid și jakarta.validation.constraints.NotBlank.
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
Compilatorul nu știa de unde vin @Valid și @NotBlank. Importurile din jakarta.validation le fac cunoscute, iar validarea funcționează: numele gol e respins cu 400. În proiectul real, aceleași importuri cer și dependența spring-boot-starter-validation; fără ea, chiar și importul corect dă package jakarta.validation does not exist.
Alte forme ale mesajului
package jakarta.validation.constraints does not existCannot resolve symbol 'validation'
Cum o eviți pe viitor
- Bifează „Validation” în Spring Initializr când creezi un API.
- După ce modifici
pom.xml, reîncarcă proiectul în IDE. - Folosește starter-ele Spring Boot în loc de dependențe individuale: versiunile sunt potrivite automat.
- Lasă IDE-ul să adauge importurile (Alt+Enter în IntelliJ).
Întrebări frecvente
Trebuie să scriu versiunea dependenței?
Nu, dacă proiectul are ca părinte spring-boot-starter-parent (sau BOM-ul Spring Boot): versiunea vine de acolo.
Cum adaug în Gradle?
implementation 'org.springframework.boot:spring-boot-starter-validation'.
Erori înrudite
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). 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. 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.
