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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Variabilele din cale (@PathVariable) și parametrii din query (@RequestParam) sosesc ca texte. Spring le convertește în tipul din metodă (long, int, UUID, LocalDate, enum). Dacă textul nu se potrivește, aruncă MethodArgumentTypeMismatchException și răspunde 400: Method parameter 'id' (numele parametrului), to required type 'long' (tipul cerut), For input string: "recomandate" (textul primit).
O cauză frecventă e mai subtilă decât un client care trimite litere: o rută literală (/produse/recomandate) e scrisă greșit sau lipsește, iar cererea se potrivește cu ruta generală /produse/{id}. Spring încearcă atunci să transforme cuvântul recomandate în număr.
Pentru enum-uri, mesajul spune tipul enum-ului; acceptate sunt doar numele constantelor, exact cum sunt scrise.
De ce apare: cauzele frecvente
1Ruta literală e scrisă greșit
@GetMapping("/produse/{id}") ...
@GetMapping("/produse/recomandat") ...
// cererea: /produse/recomandate@GetMapping("/produse/{id}") ...
@GetMapping("/produse/recomandate") ...Fără ruta exactă, cererea cade pe /produse/{id}, iar recomandate nu e număr.
2Clientul trimite alt identificator
GET /produse/MOUSE-01 // id numeric@GetMapping("/produse/cod/{cod}")
Produs dupaCod(@PathVariable String cod) { ... }Dacă resursa se caută și după cod, dă-i o rută separată cu parametru String.
3Valoare de enum scrisă altfel
GET /comenzi?status=livrata // enum: LIVRATAGET /comenzi?status=LIVRATAConversia implicită folosește numele exact al constantei.
Repară eroarea, direct în pagină
GET /produse/recomandate răspunde 400: Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'. Ruta pentru recomandări există, dar e scrisă greșit. Corecteaz-o ca recomandările să funcționeze, iar GET /produse/2 să meargă în continuare.
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.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final Map<Long, String> produse = Map.of(1L, "Mouse", 2L, "Tastatură");
@GetMapping("/produse/{id}")
String unul(@PathVariable long id) {
return produse.getOrDefault(id, "necunoscut");
}
@GetMapping("/produse/recomandat")
List<String> recomandate() {
return List.of("Tastatură");
}
}Tomcat started on port 8080 (http) Started Application GET /produse/recomandate → 200 ["Tastatură"] GET /produse/2 → 200 Tastatură
Indiciu
Compară calea din a doua metodă cu adresa cerută, literă cu literă.
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.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class ProdusController {
private final Map<Long, String> produse = Map.of(1L, "Mouse", 2L, "Tastatură");
@GetMapping("/produse/{id}")
String unul(@PathVariable long id) {
return produse.getOrDefault(id, "necunoscut");
}
@GetMapping("/produse/recomandate")
List<String> recomandate() {
return List.of("Tastatură");
}
}De ce merge
Cu ruta scrisă /produse/recomandat, cererea /produse/recomandate nu avea potrivire exactă și a fost prinsă de tiparul /produse/{id}. Spring a încercat apoi să convertească recomandate în long și a răspuns 400. Odată corectată, ruta literală e mai specifică decât {id} și câștigă, iar numerele merg în continuare pe ruta generală.
Alte forme ale mesajului
Method parameter 'status': Failed to convert value of type 'java.lang.String' to required type 'StatusComanda'Failed to convert value of type 'java.lang.String' to required type 'java.util.UUID'; Invalid UUID string: abc
Cum o eviți pe viitor
- Pune rutele literale (
/produse/recomandate) lângă cele cu variabile și testează-le pe amândouă. - Folosește prefixe diferite pentru identificatori de tipuri diferite (
/produse/{id},/produse/cod/{cod}). - Tratează
MethodArgumentTypeMismatchExceptionîntr-un@RestControllerAdviceca să răspunzi cu un mesaj clar. - Validează formatul identificatorilor și în client, înainte de cerere.
Întrebări frecvente
Spring alege /produse/recomandate sau /produse/{id}?
Ruta literală câștigă când există: Spring preferă tiparul mai specific. Problema apare doar când ruta literală lipsește sau e scrisă greșit.
Pot accepta enum-uri cu litere mici?
Da, cu un Converter<String, StatusComanda> propriu, înregistrat în WebMvcConfigurer.addFormatters.
Erori înrudite
Required request parameter 'pagina' for method parameter type int is not present Metoda are un parametru @RequestParam obligatoriu, iar cererea nu îl conține în query (?pagina=1), deci Spring răspunde 400. Trimite parametrul, sau fă-l opțional cu defaultValue = "0" / required = false. Ambiguous handler methods mapped for '/produse/A12': {ProdusController#dupaId(long), ProdusController#dupaCod(String)} Două rute cu variabile pe aceeași poziție (/produse/{id} și /produse/{cod}) se potrivesc la fel de bine cu cererea, iar Spring nu poate alege și răspunde 500. Dă-le forme diferite, de exemplu /produse/{id} și /produse/cod/{cod}. Failed to convert value of type 'java.lang.String' to required type 'int'; For input string: "zece" O proprietate injectată cu @Value într-un câmp numeric are în configurare un text care nu e număr. Scrie în application.properties o valoare numerică (10, nu zece), fără spații sau unități, sau schimbă tipul câmpului. Î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.
