...
Eroare Spring Boot · Excepții și răspunsuri de eroare

java.lang.NumberFormatException: For input string: "doi"

Pe scurt

Codul tău a apelat Integer.parseInt (sau Long.parseLong) pe un text care nu e număr, de exemplu dintr-un antet sau dintr-o proprietate. Excepția neprinsă devine 500. Prinde NumberFormatException și răspunde 400, sau lasă Spring să convertească parametrul (@RequestHeader int).

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

Ce înseamnă

NumberFormatException vine din Java, nu din Spring: Integer.parseInt("doi") nu poate transforma textul în număr. Partea For input string: "doi" arată exact textul primit, inclusiv spațiile (" 7") sau textul gol ("").

Într-o aplicație Spring apare când citești o valoare ca String și o convertești singur: un antet HTTP, un parametru, un câmp dintr-un fișier sau o valoare din baza de date. Fiind o excepție neprinsă în controller, Spring răspunde 500 și scrie în jurnal Servlet.service() ... threw exception [Request processing failed: java.lang.NumberFormatException: For input string: "doi"].

Diferența față de parametrii declarați direct ca număr (@RequestParam int pagina): acolo conversia o face Spring și răspunde singur 400 (Failed to convert value of type 'java.lang.String' to required type 'int'). Când convertești tu, tratarea erorii e tot treaba ta.

De ce apare: cauzele frecvente

1Conversie manuală fără tratarea erorii

Greșit
JAVA
int pagina = Integer.parseInt(antet);
Corect
JAVA
int pagina;
try {
    pagina = Integer.parseInt(antet);
} catch (NumberFormatException e) {
    throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "X-Pagina trebuie să fie un număr");
}

Textul greșit vine de la client, deci răspunsul corect e 400 cu un mesaj clar, nu 500.

2Conversia o poate face Spring

Greșit
JAVA
@RequestHeader("X-Pagina") String antet
// apoi Integer.parseInt(antet)
Corect
JAVA
@RequestHeader("X-Pagina") int pagina

Spring convertește antetul și răspunde singur 400 la o valoare greșită.

3Spații sau separatori în text

Greșit
JAVA
Integer.parseInt(" 7");
Integer.parseInt("1.000");
Corect
JAVA
Integer.parseInt(" 7".trim());
Integer.parseInt("1.000".replace(".", ""));

parseInt nu acceptă spații sau separatori de mii; curăță textul înainte.

Repară tu

Repară eroarea, direct în pagină

Aplicația mobilă trimite pagina în antetul X-Pagina. Pentru X-Pagina: doi, GET /produse răspunde 500 din cauza unui NumberFormatException. Răspunde în schimb 400 cu mesajul X-Pagina trebuie să fie un număr; pagina 2 trebuie să meargă ca înainte.

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.http.HttpStatus;
import org.springframework.web.server.ResponseStatusException;
import java.util.*;

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@RestController
class ProdusController {
    private final List<String> produse = List.of("Mouse", "Tastatură", "Monitor", "Căști");

    // Aplicația mobilă trimite pagina în antetul X-Pagina
    @GetMapping("/produse")
    List<String> pagina(@RequestHeader("X-Pagina") String antet) {
        // TODO: o valoare care nu e număr trebuie să dea 400, nu 500
        int pagina = Integer.parseInt(antet);
        int start = Math.min((pagina - 1) * 2, produse.size());
        return produse.subList(start, Math.min(start + 2, produse.size()));
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /produse → 200
["Monitor","Căști"]
GET /produse → 400
{"status":400,"error":"Bad Request","message":"X-Pagina trebuie să fie un număr","path":"/produse"}
Indiciu

Pune Integer.parseInt într-un try și transformă NumberFormatException într-un ResponseStatusException cu BAD_REQUEST.

Alte forme ale mesajului

  • java.lang.NumberFormatException: For input string: ""
  • java.lang.NumberFormatException: Cannot parse null string: null
  • Request processing failed: java.lang.NumberFormatException: For input string: "doi"

Cum o eviți pe viitor

  • Declară parametrii, antetele și proprietățile direct cu tipul numeric: Spring face conversia și validarea.
  • Când convertești singur, prinde NumberFormatException și transformă-l în 400.
  • Curăță textul (trim) înainte de conversie.
  • Adaugă un handler global pentru NumberFormatException dacă ai multe conversii manuale.

Întrebări frecvente

De ce primesc 500, deși greșeala e a clientului?

Spring nu știe că excepția vine din datele clientului: orice excepție neprinsă din codul tău devine 500. Tu trebuie s-o traduci în 400.

Cum arată mesajul pentru null?

Integer.parseInt(null) dă Cannot parse null string: null, de exemplu când antetul lipsește și l-ai declarat opțional.

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.