...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Failed to convert value of type 'java.lang.String' to required type 'java.time.LocalDate'

Pe scurt

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

Greșit
JAVA
@GetMapping("/rezervari")
String rezervari(@RequestParam LocalDate data) { ... }
// GET /rezervari?data=15.03.2026
Corect
JAVA
@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ă

Greșit
JAVA
GET /rezervari?data=2026-3-5
Corect
JAVA
GET /rezervari?data=2026-03-05

Formatul ISO cere două cifre pentru lună și zi; fără ele, parsarea eșuează.

3Vrei același format în toată aplicația

Greșit
JAVA
// @DateTimeFormat repetat pe fiecare parametru
Corect
JAVA
# application.properties
spring.mvc.format.date=dd.MM.yyyy

Proprietatea setează formatul implicit pentru toate datele primite ca parametri în Spring MVC.

Repară tu

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.

Codul care dă eroarea
JAVA
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;
    }
}
După reparație, programul afișează
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).

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 @DateTimeFormat sau spring.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

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