...
Eroare Spring Boot · Rute și cereri HTTP: 404, 405, 400

Method parameter 'id': Failed to convert value of type 'java.lang.String' to required type 'long'; For input string: "recomandate"

Pe scurt

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

Greșit
JAVA
@GetMapping("/produse/{id}") ...
@GetMapping("/produse/recomandat") ...
// cererea: /produse/recomandate
Corect
JAVA
@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

Greșit
JAVA
GET /produse/MOUSE-01   // id numeric
Corect
JAVA
@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

Greșit
JAVA
GET /comenzi?status=livrata   // enum: LIVRATA
Corect
JAVA
GET /comenzi?status=LIVRATA

Conversia implicită folosește numele exact al constantei.

Repară tu

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.

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.*;

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

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 @RestControllerAdvice ca 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

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