...
Eroare Spring Boot · Validare

package jakarta.validation does not exist

Pe scurt

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

Greșit
JAVA
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
</dependency>
Corect
JAVA
<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

Greșit
JAVA
// pom.xml modificat, IDE-ul încă arată roșu
Corect
JAVA
./mvnw compile
// sau Reload All Maven Projects în IntelliJ

IDE-ul trebuie să descarce dependența și să actualizeze classpath-ul.

3Adnotare folosită fără import

Greșit
JAVA
record Salut(@NotBlank String nume) { }  // fără import
Corect
JAVA
import jakarta.validation.constraints.NotBlank;

Fiecare adnotare trebuie importată din pachetul ei.

Repară tu

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

Codul care dă eroarea
JAVA
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() + "!";
    }
}
După reparație, programul afișează
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.

Alte forme ale mesajului

  • package jakarta.validation.constraints does not exist
  • Cannot 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

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