java.lang.NumberFormatException: For input string: "doi"
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
int pagina = Integer.parseInt(antet);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
@RequestHeader("X-Pagina") String antet
// apoi Integer.parseInt(antet)@RequestHeader("X-Pagina") int paginaSpring convertește antetul și răspunde singur 400 la o valoare greșită.
3Spații sau separatori în text
Integer.parseInt(" 7");
Integer.parseInt("1.000");Integer.parseInt(" 7".trim());
Integer.parseInt("1.000".replace(".", ""));parseInt nu acceptă spații sau separatori de mii; curăță textul înainte.
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.
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()));
}
}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.
Reparația
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) {
int pagina;
try {
pagina = Integer.parseInt(antet);
} catch (NumberFormatException e) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "X-Pagina trebuie să fie un număr");
}
int start = Math.min((pagina - 1) * 2, produse.size());
return produse.subList(start, Math.min(start + 2, produse.size()));
}
}De ce merge
Integer.parseInt("doi") arunca NumberFormatException, iar excepția neprinsă devenea 500. Acum o prinzi și arunci ResponseStatusException cu BAD_REQUEST și un mesaj pentru client, deci greșeala clientului primește 400. O variantă la fel de bună e @RequestHeader("X-Pagina") int pagina: Spring convertește singur și răspunde 400 la text.
Alte forme ale mesajului
java.lang.NumberFormatException: For input string: ""java.lang.NumberFormatException: Cannot parse null string: nullRequest 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
NumberFormatExceptiondacă 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
Required request header 'X-API-Key' for method parameter type String is not present Metoda cere un antet HTTP cu @RequestHeader, iar cererea nu îl are, deci Spring răspunde 400. Trimite antetul din client sau fă-l opțional cu required = false / defaultValue. Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate" Valoarea din cale sau din query nu se poate converti în tipul parametrului (aici un text în loc de număr), deci Spring răspunde 400. Adesea cererea a ajuns la ruta /{id} din greșeală: verifică ruta dedicată și tipul parametrului. Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed: java.lang.IllegalStateException: Stoc insuficient pentru Mouse] with root cause O excepție aruncată din controller sau serviciu nu a fost tratată nicăieri, a ajuns până la servlet, iar clientul a primit 500. Excepția reală e în paranteze și în stiva de sub mesaj. Repar-o sau trateaz-o cu un @ExceptionHandler care întoarce statusul potrivit. Î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.
