Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDate'
Un parametru din adresă (de exemplu ?data=15.03.2026) nu poate fi convertit în LocalDate, pentru că Spring acceptă implicit doar formatul ISO 2026-03-15. Răspunsul este 400. Trimite data ca 2026-03-15 sau declară formatul cu @DateTimeFormat(pattern = "dd.MM.yyyy").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la conversia parametrilor @RequestParam / @PathVariable: Spring a primit textul din URL și trebuia să-l transforme în java.time.LocalDate. Fără nicio indicație de format, conversia folosește formatul ISO (yyyy-MM-dd), deci 15.03.2026 sau 03/15/2026 eșuează. Spring aruncă MethodArgumentTypeMismatchException și răspunde 400 Bad Request.
Mesajul complet arată și valoarea: Method parameter 'data': Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDate'; Failed to convert from type [java.lang.String] to type [@org.springframework.web.bind.annotation.RequestParam java.time.LocalDate] for value [15.03.2026]. Partea for value [...] îți spune exact ce a trimis clientul.
Atenție: e altă eroare decât Cannot deserialize value of type java.time.LocalDate, care apare când data vine în corpul JSON (acolo se ocupă Jackson, cu @JsonFormat).
De ce apare: cauzele frecvente
1Clientul trimite data în format românesc
@GetMapping("/rezervari")
String rezervari(@RequestParam LocalDate data) { ... }
// GET /rezervari?data=15.03.2026@GetMapping("/rezervari")
String rezervari(@RequestParam
@DateTimeFormat(pattern = "dd.MM.yyyy") LocalDate data) { ... }@DateTimeFormat îi spune convertorului ce format să folosească pentru acest parametru.
2Formatul ISO e cel corect, dar clientul nu-l respectă
GET /rezervari?data=2026-3-5GET /rezervari?data=2026-03-05Formatul ISO cere două cifre pentru lună și zi; fără ele, parsarea eșuează.
3Vrei același format în toată aplicația
// @DateTimeFormat repetat pe fiecare parametru# application.properties
spring.mvc.format.date=dd.MM.yyyyProprietatea setează formatul implicit pentru toate datele primite ca parametri în Spring MVC.
Repară eroarea, direct în pagină
Aplicația de la recepție cere GET /rezervari?data=15.03.2026 și primește 400 cu Failed to convert value of type 'java.lang.String' to required type 'LocalDate'. Laboratorul nu are @DateTimeFormat, așa că primește data ca text și construiește singur LocalDate, ca răspunsul să fie Rezervări pentru 2026-03-15.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class RezervareController {
// Aplicația de la recepție trimite data ca 15.03.2026 (zi.lună.an)
@GetMapping("/rezervari")
String rezervari(@RequestParam LocalDate data) {
// TODO: primește data ca text și transform-o în LocalDate
return "Rezervări pentru " + data;
}
}Tomcat started on port 8080 (http) Started Application GET /rezervari?data=15.03.2026 → 200 Rezervări pentru 2026-03-15
Indiciu
Împarte textul după punct cu split("\\.") și folosește LocalDate.of(an, luna, zi).
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class RezervareController {
// Aplicația de la recepție trimite data ca 15.03.2026 (zi.lună.an)
@GetMapping("/rezervari")
String rezervari(@RequestParam String data) {
String[] p = data.split("\\.");
LocalDate zi = LocalDate.of(Integer.parseInt(p[2]), Integer.parseInt(p[1]), Integer.parseInt(p[0]));
return "Rezervări pentru " + zi;
}
}De ce merge
Spring încerca să citească 15.03.2026 în format ISO și răspundea 400 înainte să intre în metodă. Primind parametrul ca String, conversia o faci tu: împarți textul în zi, lună și an și creezi data cu LocalDate.of. În proiect, soluția mai scurtă este @DateTimeFormat(pattern = "dd.MM.yyyy") pe parametru, cu același rezultat.
Alte forme ale mesajului
Method parameter 'data': Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDate'Failed to convert from type [java.lang.String] to type [@org.springframework.web.bind.annotation.RequestParam java.time.LocalDate] for value [15.03.2026]Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDateTime'
Cum o eviți pe viitor
- Folosește formatul ISO (
2026-03-15) în API-uri: e standard și nu depinde de țară. - Când clientul nu poate trimite ISO, declară formatul cu
@DateTimeFormatsauspring.mvc.format.date. - Documentează formatul datei în specificația API.
- Tratează
MethodArgumentTypeMismatchExceptionîntr-un@RestControllerAdvice, cu un mesaj clar pentru client.
Întrebări frecvente
De ce @JsonFormat nu rezolvă eroarea?
@JsonFormat se aplică doar când data vine în corpul JSON. Parametrii din URL trec prin conversia Spring MVC, care citește @DateTimeFormat.
Primesc 400 fără niciun mesaj. Cum văd motivul?
Pune server.error.include-message=always în dezvoltare sau uită-te în jurnal după linia Resolved [...MethodArgumentTypeMismatchException...].
Erori înrudite
Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate" Valoarea din cale sau din query nu se poate converti în tipul parametrului (aici un text în loc de număr), deci Spring răspunde 400. Adesea cererea a ajuns la ruta /{id} din greșeală: verifică ruta dedicată și tipul parametrului. JSON parse error: Cannot deserialize value of type `java.time.LocalDate` from String "01.03.2026": Failed to deserialize java.time.LocalDate Data din JSON nu e în formatul ISO pe care îl așteaptă Jackson pentru LocalDate (aaaa-ll-zz, de exemplu 2026-03-01). Trimite data în format ISO sau declară formatul pe câmp cu @JsonFormat(pattern = "dd.MM.yyyy"). Required request parameter 'pagina' for method parameter type int is not present Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false. Î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.
