...
Eroare Spring Boot · Validare

package javax.validation.constraints does not exist

Pe scurt

Î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

Greșit
JAVA
import javax.validation.Valid;
import javax.validation.constraints.NotBlank;
Corect
JAVA
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

Greșit
JAVA
<artifactId>validation-api</artifactId>
<groupId>javax.validation</groupId>
Corect
JAVA
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>

Starter-ul aduce versiunea Jakarta potrivită cu Boot 3.

Repară tu

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

Codul care dă eroarea
JAVA
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() + "!";
    }
}
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

În Spring Boot 3 pachetul începe cu jakarta.

Alte forme ale mesajului

  • package javax.validation does not exist
  • error: 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 javax se mută. javax.sql și javax.crypto rămân în JDK.
  • Elimină din pom.xml dependențele javax.validation ră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

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