...
Eroare Spring Boot · JSON și Jackson

JSON parse error: Cannot deserialize value of type `int` from String "doi": not a valid `int` value

Pe scurt

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

Greșit
JAVA
{"produs": "Mouse", "cantitate": "doi"}
Corect
JAVA
{"produs": "Mouse", "cantitate": 2}

Doar cifrele se pot converti în int.

2Unitate lipită de număr

Greșit
JAVA
{"cantitate": "2 buc"}
Corect
JAVA
{"cantitate": 2}

Unitatea se trimite separat sau deloc; câmpul numeric primește doar numărul.

3Valoare goală dintr-un formular

Greșit
JAVA
{"cantitate": ""}
Corect
JAVA
{"cantitate": null}  // cu Integer cantitate

Pentru valori lipsă folosește null și un tip obiect (Integer).

Repară tu

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.

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

Alte forme ale mesajului

  • Cannot deserialize value of type `long` from String "abc": not a valid `long` value
  • Cannot 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 @RestControllerAdvice ca 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

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