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.
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)
POST /clienti {"nume": "", "email": "ana"}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
// niciun handler: clientul primește doar status 400@ExceptionHandler(MethodArgumentNotValidException.class)
ResponseEntity<Map<String, String>> invalid(MethodArgumentNotValidException e) { ... }Un handler transformă erorile în JSON util pentru formular.
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).
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 MethodArgumentNotValidExceptionTomcat 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().
Reparația
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() + "!";
}
}
@RestControllerAdvice
class EroriValidare {
@ExceptionHandler(MethodArgumentNotValidException.class)
ResponseEntity<Map<String, String>> invalid(MethodArgumentNotValidException e) {
Map<String, String> erori = new TreeMap<>();
e.getBindingResult().getFieldErrors()
.forEach(f -> erori.put(f.getField(), f.getDefaultMessage()));
return ResponseEntity.badRequest().body(erori);
}
}De ce merge
Validarea a funcționat de la început: @Valid a respins numele gol și emailul fără @. Lipsea un răspuns util. Handler-ul din @RestControllerAdvice primește excepția, parcurge getFieldErrors() și construiește harta câmp -> mesaj, pe care o întoarce cu 400. TreeMap păstrează câmpurile ordonate, deci răspunsul e stabil. Cererea validă trece neatinsă.
Alte forme ale mesajului
Validation failed for object='clientNou'. Error count: 2Resolved [org.springframework.web.bind.MethodArgumentNotValidException: Validation failed for argument [0] in public ...
Cum o eviți pe viitor
- Pune
@Validpe fiecare@RequestBodycare are reguli. - Ține un singur
@RestControllerAdvicecare transformă erorile de validare într-un format stabil (de exempluProblemDetailcu 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
must not be blank Este mesajul implicit al lui @NotBlank: câmpul a lipsit, a fost null, gol sau doar spații. Trimite o valoare, iar dacă vrei un mesaj pentru utilizatori, scrie-l în adnotare: @NotBlank(message = "Numele este obligatoriu"). must be a well-formed email address Este mesajul implicit al lui @Email: valoarea nu arată ca o adresă de email. Atenție: @Email acceptă null și textul gol, deci pentru un email obligatoriu pune și @NotBlank. size must be between 3 and 50 Este mesajul implicit al lui @Size: lungimea textului (sau numărul de elemente al listei) e în afara intervalului. Atenție: @Size acceptă null, deci pentru un câmp obligatoriu adaugă @NotNull sau @NotBlank. Î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.
