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").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot configurează Jackson cu modulul pentru java.time. Pentru LocalDate, formatul implicit este ISO-8601: "2026-03-01". Orice alt format ("01.03.2026", "1/3/2026", "2026-3-1") eșuează cu Cannot deserialize value of type java.time.LocalDate from String "01.03.2026": Failed to deserialize java.time.LocalDate: (java.time.format.DateTimeParseException) Text '01.03.2026' could not be parsed at index 0.
at index 0 arată poziția din text unde parsarea a eșuat: aici chiar primul caracter, pentru că se aștepta anul. Pentru LocalDateTime formatul ISO este 2026-03-01T14:30:00; un spațiu în loc de T produce aceeași eroare, la indexul 10.
Cel mai simplu e ca API-ul să folosească ISO peste tot. Dacă trebuie să accepți alt format, pune @JsonFormat(pattern = "dd.MM.yyyy") pe câmp.
De ce apare: cauzele frecvente
1Format românesc de dată
{"data": "01.03.2026"}{"data": "2026-03-01"}Formatul implicit pentru LocalDate este ISO: an, lună, zi.
2Ora separată prin spațiu
{"creat": "2026-03-01 14:30:00"} // LocalDateTime{"creat": "2026-03-01T14:30:00"}ISO-8601 folosește T între dată și oră.
3Formatul nu se poate schimba la client
record Livrare(LocalDate data) { }record Livrare(@JsonFormat(pattern = "dd.MM.yyyy") LocalDate data) { }@JsonFormat spune exact ce format are textul primit.
Repară eroarea, direct în pagină
GET /import răspunde 500: Cannot deserialize value of type java.time.LocalDate from String "01.03.2026". Corectează data din constanta JSON în formatul ISO, ca ruta să răspundă Livrare în Cluj pe 2026-03-01.
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 com.fasterxml.jackson.databind.ObjectMapper;
import java.math.BigDecimal;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Livrare(String oras, LocalDate data) {
}
@RestController
class ImportController {
// textul primit de la furnizor (în aplicația reală vine dintr-un fișier sau dintr-un API)
static final String JSON = """
{"oras": "Cluj", "data": "01.03.2026"}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
Livrare l = mapper.readValue(JSON, Livrare.class);
return "Livrare în " + l.oras() + " pe " + l.data();
}
}Tomcat started on port 8080 (http) Started Application GET /import → 200 Livrare în Cluj pe 2026-03-01
Indiciu
Formatul ISO este an-lună-zi, cu cratime.
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 com.fasterxml.jackson.databind.ObjectMapper;
import java.math.BigDecimal;
import java.time.LocalDate;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
record Livrare(String oras, LocalDate data) {
}
@RestController
class ImportController {
// textul primit de la furnizor (în aplicația reală vine dintr-un fișier sau dintr-un API)
static final String JSON = """
{"oras": "Cluj", "data": "2026-03-01"}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
Livrare l = mapper.readValue(JSON, Livrare.class);
return "Livrare în " + l.oras() + " pe " + l.data();
}
}De ce merge
Pentru LocalDate, Jackson folosește formatul ISO-8601 (aaaa-ll-zz). Textul 01.03.2026 nu respectă formatul încă de la primul caracter (se aștepta anul), de unde could not be parsed at index 0. Cu 2026-03-01, conversia reușește, iar data este afișată tot în ISO. Dacă sursa datelor nu se poate schimba, varianta de pe server este @JsonFormat(pattern = "dd.MM.yyyy") pe câmp.
Alte forme ale mesajului
Text '01.03.2026' could not be parsed at index 0Cannot deserialize value of type `java.time.LocalDateTime` from String "2026-03-01 14:30"
Cum o eviți pe viitor
- Folosește formatul ISO-8601 în tot API-ul: e standard, se sortează corect și nu depinde de limbă.
- Formatează data pentru utilizator doar în interfață, nu în JSON.
- Dacă un partener impune alt format, declară-l explicit cu
@JsonFormatpe câmpurile respective. - Testează cu zile mai mari ca 12, ca să prinzi confuziile zi-lună.
Întrebări frecvente
De ce "2026-3-1" nu merge?
ISO cere două cifre pentru lună și zi: 2026-03-01.
Cum scrie Spring Boot datele în răspuns?
Tot în ISO ("2026-03-01"), pentru că Boot dezactivează scrierea datelor ca numere.
Erori înrudite
JSON parse error: Cannot deserialize value of type `StatusComanda` from String "livrata": not one of the values accepted for Enum class: [NOUA, LIVRATA, ANULATA] Valoarea din JSON nu corespunde exact niciunei constante a enum-ului: implicit, Jackson cere numele scris identic, cu aceleași majuscule. Trimite "LIVRATA", activează acceptarea fără majuscule sau mapează valorile cu @JsonProperty. JSON parse error: Cannot deserialize value of type `int` from String "doi": not a valid `int` value Un câmp numeric din JSON are un text care nu e număr ("doi", "", "10 buc"). Jackson poate converti "2" în 2, dar nu și cuvinte. Trimite numărul ca număr JSON (2) sau corectează sursa datelor. JSON parse error: Cannot deserialize value of type `java.math.BigDecimal` from String "12,50": not a valid representation Un câmp BigDecimal (sau double) a primit un text cu virgulă zecimală, cu simbol de monedă sau cu spații. JSON folosește punctul: trimite 12.50 ca număr (sau "12.50" ca text). Î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.
