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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Jackson convertește valorile JSON în tipurile câmpurilor record-ului sau clasei. Pentru un câmp int, acceptă un număr (2) și chiar un text care conține doar cifre ("2"). Un text care nu e număr ("doi", "2 buc", "2,5") nu se poate converti, așa că primești InvalidFormatException: Cannot deserialize value of type int from String "doi": not a valid int value.
Mesajul complet continuă cu calea câmpului: (through reference chain: LinieComanda["cantitate"]), care îți spune exact ce câmp a picat, inclusiv în obiecte imbricate și liste (Comanda["linii"]->java.util.ArrayList[0]->LinieComanda["cantitate"]).
Într-un controller, eroarea devine 400 Bad Request. Același tip de mesaj apare pentru long, double, boolean ("da" nu e true) și BigDecimal.
De ce apare: cauzele frecvente
1Număr scris în litere
{"produs": "Mouse", "cantitate": "doi"}{"produs": "Mouse", "cantitate": 2}Doar cifrele se pot converti în int.
2Unitate lipită de număr
{"cantitate": "2 buc"}{"cantitate": 2}Unitatea se trimite separat sau deloc; câmpul numeric primește doar numărul.
3Valoare goală dintr-un formular
{"cantitate": ""}{"cantitate": null} // cu Integer cantitatePentru valori lipsă folosește null și un tip obiect (Integer).
Repară eroarea, direct în pagină
GET /import răspunde 500: Cannot deserialize value of type int from String "doi". Furnizorul a scris cantitatea în litere. Corectează constanta JSON ca să conțină cantitatea ca număr, iar ruta să răspundă 2 x Mouse.
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 LinieComanda(String produs, int cantitate) {
}
@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": "Mouse", "cantitate": "doi"}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
LinieComanda l = mapper.readValue(JSON, LinieComanda.class);
return l.cantitate() + " x " + l.produs();
}
}Tomcat started on port 8080 (http) Started Application GET /import → 200 2 x Mouse
Indiciu
Câmpul cantitate este int: în JSON scrie 2, fără ghilimele.
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 LinieComanda(String produs, int cantitate) {
}
@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": "Mouse", "cantitate": 2}
""";
private final ObjectMapper mapper;
ImportController(ObjectMapper mapper) {
this.mapper = mapper;
}
@GetMapping("/import")
String importa() throws Exception {
LinieComanda l = mapper.readValue(JSON, LinieComanda.class);
return l.cantitate() + " x " + l.produs();
}
}De ce merge
Câmpul cantitate este int, iar Jackson poate converti doar numere (sau texte care conțin cifre). Cuvântul doi nu e număr, deci conversia a eșuat cu numele câmpului și valoarea primită. Cu "cantitate": 2, valoarea e un număr JSON, iar record-ul se creează. Când datele vin de la un client prin @RequestBody, Spring răspunde 400, iar reparația se face în client.
Alte forme ale mesajului
Cannot deserialize value of type `long` from String "abc": not a valid `long` valueCannot deserialize value of type `boolean` from String "da": only "true" or "false" recognized
Cum o eviți pe viitor
- Trimite numerele din client ca numere JSON, nu ca texte (convertește valorile din formulare înainte de
JSON.stringify). - Folosește tipuri obiect (
Integer) pentru câmpuri opționale și validează-le cu@NotNull,@Min. - Tratează
HttpMessageNotReadableExceptionîntr-un@RestControllerAdviceca să răspunzi cu numele câmpului greșit.
Întrebări frecvente
De ce "2" (cu ghilimele) funcționează?
Jackson acceptă implicit texte care conțin un număr valid pentru câmpurile numerice. Nu se bazează pe asta: trimite numere ca numere.
Cum aflu câmpul din mesaj?
Partea through reference chain de la final arată clasa și câmpul, de exemplu LinieComanda["cantitate"].
Erori înrudite
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). 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: 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.
