...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `java.time.LocalDate` from String "01.03.2026": Failed to deserialize java.time.LocalDate

Pe scurt

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ă

Greșit
JAVA
{"data": "01.03.2026"}
Corect
JAVA
{"data": "2026-03-01"}

Formatul implicit pentru LocalDate este ISO: an, lună, zi.

2Ora separată prin spațiu

Greșit
JAVA
{"creat": "2026-03-01 14:30:00"}  // LocalDateTime
Corect
JAVA
{"creat": "2026-03-01T14:30:00"}

ISO-8601 folosește T între dată și oră.

3Formatul nu se poate schimba la client

Greșit
JAVA
record Livrare(LocalDate data) { }
Corect
JAVA
record Livrare(@JsonFormat(pattern = "dd.MM.yyyy") LocalDate data) { }

@JsonFormat spune exact ce format are textul primit.

Repară tu

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.

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

Alte forme ale mesajului

  • Text '01.03.2026' could not be parsed at index 0
  • Cannot 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 @JsonFormat pe 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

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