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).
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ă
{"valoare": "12,50"}{"valoare": 12.50}Separatorul zecimal în JSON este punctul.
2Monedă sau separator de mii
{"valoare": "1.250,00 lei"}{"valoare": 1250.00}Formatarea pentru afișare nu are ce căuta în date.
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.
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";
}
}Tomcat started on port 8080 (http) Started Application GET /import → 200 Cablu USB: 12.50 lei
Indiciu
Separatorul zecimal în JSON este punctul.
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 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";
}
}De ce merge
BigDecimal se construiește dintr-un text cu formatul numeric Java, cu punct zecimal. 12,50 are virgulă, deci conversia a eșuat cu not a valid representation. Cu 12.50 (aici ca text, ca să păstreze exact cele două zecimale), Jackson creează BigDecimal cu scala 2, iar afișarea păstrează 12.50. Sumele formatate „pentru oameni” trebuie convertite înainte să ajungă în JSON.
Alte forme ale mesajului
Cannot deserialize value of type `double` from String "12,5": not a valid `double` valueCharacter , 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
BigDecimalpentru bani (nudouble) și creează-l din text, nu dindouble. - 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
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.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"). JSON parse error: Unrecognized token 'Mouse': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') Jackson a găsit un cuvânt care nu e o valoare JSON validă, de obicei un text fără ghilimele (Mouse în loc de "Mouse") sau un corp care nu e JSON deloc. Pune textele între ghilimele duble și trimite JSON valid. Î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.
