...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `java.math.BigDecimal` from String "12,50": not a valid representation

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Jackson acceptă pentru BigDecimal un număr JSON (12.50) sau un text care conține un număr scris în formatul Java ("12.50"). Formatul local românesc, cu virgulă zecimală ("12,50"), separatorii de mii ("1.250,00"), moneda ("12.50 lei") sau spațiile nu sunt numere valide, deci primești InvalidFormatException: Cannot deserialize value of type java.math.BigDecimal from String "12,50": not a valid representation.

Mesajul continuă de obicei cu cauza tehnică (Character , is neither a decimal digit number, decimal point, nor "e" notation exponential mark.) și cu calea câmpului.

Apare des când datele vin din Excel, din formulare completate de oameni sau din sisteme care formatează sumele pentru afișare. Regula: în JSON sumele circulă ca numere simple, iar formatarea pentru oameni se face doar la afișare.

De ce apare: cauzele frecvente

1Virgulă zecimală

Greșit
JAVA
{"valoare": "12,50"}
Corect
JAVA
{"valoare": 12.50}

Separatorul zecimal în JSON este punctul.

2Monedă sau separator de mii

Greșit
JAVA
{"valoare": "1.250,00 lei"}
Corect
JAVA
{"valoare": 1250.00}

Formatarea pentru afișare nu are ce căuta în date.

Repară tu

Repară eroarea, direct în pagină

GET /import răspunde 500: Cannot deserialize value of type java.math.BigDecimal from String "12,50". Prețul a fost scris cu virgulă zecimală. Corectează constanta JSON, ca ruta să răspundă Cablu USB: 12.50 lei.

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 Pret(String produs, BigDecimal valoare) {
}

@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 = """
            {"produs": "Cablu USB", "valoare": "12,50"}
            """;

    private final ObjectMapper mapper;

    ImportController(ObjectMapper mapper) {
        this.mapper = mapper;
    }

    @GetMapping("/import")
    String importa() throws Exception {
        Pret p = mapper.readValue(JSON, Pret.class);
        return p.produs() + ": " + p.valoare() + " lei";
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /import → 200
Cablu USB: 12.50 lei
Indiciu

Separatorul zecimal în JSON este punctul.

Alte forme ale mesajului

  • Cannot deserialize value of type `double` from String "12,5": not a valid `double` value
  • Character , is neither a decimal digit number, decimal point, nor "e" notation exponential mark.

Cum o eviți pe viitor

  • Trimite sumele ca numere JSON cu punct zecimal.
  • Când imporți din Excel sau CSV, convertește explicit formatul local înainte să construiești JSON-ul.
  • Folosește BigDecimal pentru bani (nu double) și creează-l din text, nu din double.
  • Formatează sumele pentru oameni doar în interfață.

Întrebări frecvente

De ce BigDecimal și nu double pentru prețuri?

double nu poate reprezenta exact multe zecimale (0.1 + 0.2 nu dă exact 0.3). BigDecimal păstrează exact valoarea scrisă, inclusiv scala (12.50).

Pot trimite suma ca text?

Da, "12.50" e acceptat pentru BigDecimal. Important e formatul numărului, nu ghilimelele.

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.