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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
@Email verifică forma adresei (o parte locală, @, un domeniu). Dacă valoarea nu respectă forma, mesajul implicit este must be a well-formed email address.
Capcana frecventă: ca aproape toate adnotările Bean Validation, @Email consideră valide null și textul gol "". Regula generală este că fiecare adnotare verifică un singur lucru, iar „câmpul trebuie să existe” e treaba lui @NotBlank / @NotNull. Un formular trimis cu emailul gol trece deci de validare, iar problema apare mai târziu, la trimiterea mesajelor sau ca înregistrări fără email în bază.
Verificarea lui @Email este și permisivă: acceptă ana@exemplu (fără punct în domeniu), pentru că e o adresă validă tehnic. Dacă ai reguli mai stricte, adaugă regexp sau @Pattern. Singura confirmare reală rămâne un email de verificare.
De ce apare: cauzele frecvente
1Email gol acceptat
record Abonare(@Email String email) { }
// {"email": ""} trecerecord Abonare(@NotBlank @Email String email) { }@NotBlank cere o valoare, @Email îi verifică forma.
2Adresa are o greșeală de scriere
{"email": "ana.exemplu.ro"}{"email": "ana@exemplu.ro"}Fără @, valoarea nu e o adresă.
Repară eroarea, direct în pagină
Ruta POST /abonare validează emailul cu @Email, dar un formular trimis cu emailul gol trece și răspunde Abonat: fără adresă. Fă emailul obligatoriu, ca cererea cu email gol să primească 400, iar cea cu ana@exemplu.ro să răspundă Abonat: ana@exemplu.ro.
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 Abonare(@Email String email) {
}
@RestController
class AbonareController {
@PostMapping("/abonare")
String aboneaza(@Valid @RequestBody Abonare a) {
return "Abonat: " + a.email();
}
}
@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);
}
}Tomcat started on port 8080 (http)
Started Application
POST /abonare → 400
{"email":"must not be blank"}
POST /abonare → 200
Abonat: ana@exemplu.roIndiciu
@Email verifică doar forma; obligativitatea o exprimă altă adnotare.
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 Abonare(@NotBlank @Email String email) {
}
@RestController
class AbonareController {
@PostMapping("/abonare")
String aboneaza(@Valid @RequestBody Abonare a) {
return "Abonat: " + a.email();
}
}
@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
@Email verifică doar forma adresei și consideră textul gol valid, la fel ca @Size sau @Pattern. De aceea formularul gol trecea. @NotBlank adaugă regula „câmpul trebuie completat”, cu mesajul must not be blank. Cele două adnotări lucrează împreună: una pentru prezență, alta pentru formă. Adresa corectă trece de ambele.
Alte forme ale mesajului
must be a well-formed email address (rejected value [ana])
Cum o eviți pe viitor
- Combină mereu regulile de formă (
@Email,@Pattern,@Size) cu@NotBlank/@NotNullcând câmpul e obligatoriu. - Scrie mesaje proprii pentru utilizatori.
- Pentru siguranță deplină, confirmă adresa printr-un email cu link.
- Testează explicit valorile goale, nu doar pe cele greșite.
Întrebări frecvente
De ce @Email acceptă textul gol?
Prin convenție, constrângerile Bean Validation tratează valorile absente ca valide, ca să poată fi combinate. Obligativitatea se exprimă separat.
Acceptă @Email adrese fără punct în domeniu?
Da, ana@localhost este o adresă validă tehnic. Pentru reguli stricte adaugă @Email(regexp = ".+@.+\\..+").
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"). 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. 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. Î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.
