...
Eroare Spring Boot · Validare

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]]

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când un parametru @RequestBody are @Valid, Spring rulează Bean Validation pe obiect înainte de metodă. Dacă o regulă e încălcată, metoda nu se mai apelează: se aruncă MethodArgumentNotValidException, iar răspunsul implicit e 400 Bad Request.

Mesajul are o parte pentru fiecare problemă: Field error in object 'clientNou' on field 'email' (obiectul și câmpul), rejected value [ana] (valoarea primită) și default message [must be a well-formed email address] (motivul). argument [0] este poziția parametrului în metodă. Cu server.error.include-message=always, răspunsul JSON implicit conține doar rezumatul Validation failed for object='clientNou'. Error count: 1.

Nu e o eroare de cod, ci validarea care își face treaba. Ce trebuie reparat de obicei este răspunsul: clientul are nevoie să știe ce câmpuri sunt greșite, deci excepția se tratează cu un @ExceptionHandler, care întoarce getBindingResult().getFieldErrors().

De ce apare: cauzele frecvente

1Clientul trimite date invalide (comportament corect)

Greșit
JAVA
POST /clienti {"nume": "", "email": "ana"}
Corect
JAVA
POST /clienti {"nume": "Ana", "email": "ana@exemplu.ro"}

Regulile au respins exact ce trebuiau să respingă.

2Răspunsul nu spune ce câmp e greșit

Greșit
JAVA
// niciun handler: clientul primește doar status 400
Corect
JAVA
@ExceptionHandler(MethodArgumentNotValidException.class)
ResponseEntity<Map<String, String>> invalid(MethodArgumentNotValidException e) { ... }

Un handler transformă erorile în JSON util pentru formular.

Repară tu

Repară eroarea, direct în pagină

POST /clienti cu date invalide răspunde doar Validation failed for object='clientNou'. Error count: 2, iar formularul nu știe ce câmpuri să marcheze. Adaugă un @RestControllerAdvice cu un @ExceptionHandler(MethodArgumentNotValidException.class) care întoarce 400 și un obiect câmp -> mesaj (ordonat după câmp, de exemplu TreeMap).

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 jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import org.springframework.web.bind.MethodArgumentNotValidException;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

record ClientNou(@NotBlank String nume, @Email String email) {
}

@RestController
class ClientController {
    @PostMapping("/clienti")
    String inregistreaza(@Valid @RequestBody ClientNou client) {
        return "Bun venit, " + client.nume() + "!";
    }
}

// TODO: un @RestControllerAdvice pentru MethodArgumentNotValidException
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
POST /clienti → 400
{"email":"must be a well-formed email address","nume":"must not be blank"}
POST /clienti → 200
Bun venit, Ana!
Indiciu

e.getBindingResult().getFieldErrors() dă lista câmpurilor greșite, cu getField() și getDefaultMessage().

Alte forme ale mesajului

  • Validation failed for object='clientNou'. Error count: 2
  • Resolved [org.springframework.web.bind.MethodArgumentNotValidException: Validation failed for argument [0] in public ...

Cum o eviți pe viitor

  • Pune @Valid pe fiecare @RequestBody care are reguli.
  • Ține un singur @RestControllerAdvice care transformă erorile de validare într-un format stabil (de exemplu ProblemDetail cu lista câmpurilor).
  • Dă mesaje proprii regulilor, în limba utilizatorilor (message = "...").
  • Testează cu MockMvc atât cazul valid, cât și unul invalid.

Întrebări frecvente

De ce metoda mea nu se apelează deloc?

Pentru că validarea rulează înainte de metodă. Dacă pică, Spring răspunde 400 direct.

Ce e argument [0]?

Poziția parametrului validat în semnătura metodei, numărată de la 0.

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.