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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Proprietățile sunt texte. Când le injectezi într-un câmp int, long, double sau boolean, Spring le convertește. Dacă textul nu se poate converti, crearea bean-ului eșuează cu TypeMismatchException: Failed to convert value of type 'java.lang.String' to required type 'int', urmat de motivul de la Java: For input string: "zece" (textul primit, între ghilimele).
Cazuri tipice: un număr scris în litere, un spațiu la final (10 în unele surse), o unitate lipită (10ms într-un câmp int), o virgulă zecimală (4,5 pentru double) sau o valoare de profil care suprascrie una corectă cu text.
Același mesaj, cu Method parameter 'id' în față, apare și la parametrii cererilor HTTP; acolo e o eroare 400 (vezi pagina dedicată). Aici e o eroare de pornire, din configurare.
De ce apare: cauzele frecvente
1Valoarea nu e un număr
app.limita-cos=zece
@Value("${app.limita-cos}") int limita;app.limita-cos=10Integer.parseInt("zece") nu poate funcționa; valoarea trebuie să fie scrisă cu cifre.
2Virgulă zecimală
app.tva=0,19
@Value("${app.tva}") double tva;app.tva=0.19Conversia folosește punctul ca separator zecimal, indiferent de limba sistemului.
3Unitate într-un câmp numeric
app.timeout=30s
@Value("${app.timeout}") int timeout;app.timeout=30s
@Value("${app.timeout}") Duration timeout;Pentru durate folosește tipul Duration, care înțelege 30s, 500ms, 2m.
Repară eroarea, direct în pagină
Aplicația nu pornește: Failed to convert value of type 'java.lang.String' to required type 'int'; For input string: "zece". Configurarea scrie limita coșului în litere. Rescrie application.properties în cod (comentariu bloc /* application.properties ... */) cu valoarea numerică, ca GET /cos/limita să răspundă Maximum 10 produse în coș.
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 CosController {
@Value("${app.limita-cos}")
int limita;
@GetMapping("/cos/limita")
String limita() {
return "Maximum " + limita + " produse în coș";
}
}Tomcat started on port 8080 (http) Started Application GET /cos/limita → 200 Maximum 10 produse în coș
Indiciu
Valoarea trebuie scrisă cu cifre.
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 CosController {
@Value("${app.limita-cos}")
int limita;
@GetMapping("/cos/limita")
String limita() {
return "Maximum " + limita + " produse în coș";
}
}
/* application.properties
app.limita-cos=10
*/De ce merge
Câmpul int limita cere un număr, dar configurarea conținea textul zece, pe care conversia nu-l poate transforma. Mesajul indică exact textul primit (For input string: "zece"). Cu app.limita-cos=10, conversia reușește, bean-ul se creează și aplicația pornește. Nu schimba tipul câmpului în String ca să scapi de eroare: ai muta problema în codul care face calcule.
Alte forme ale mesajului
Failed to convert value of type 'java.lang.String' to required type 'double'; For input string: "0,19"Failed to convert value of type 'java.lang.String' to required type 'boolean'; Invalid boolean value [da]
Cum o eviți pe viitor
- Scrie numerele în configurare cu cifre și punct zecimal, fără unități.
- Pentru durate și dimensiuni folosește
DurationșiDataSize, care acceptă unități. - Grupează setările într-o clasă
@ConfigurationProperties: eroarea arată apoi proprietatea, valoarea și fișierul. - Verifică și valorile din profiluri și din variabilele de mediu, care pot suprascrie fișierul principal.
Întrebări frecvente
De unde vine valoarea dacă în fișier pare corectă?
Poate fi suprascrisă de un profil activ, o variabilă de mediu sau un argument din linia de comandă. Caută cheia în toate sursele.
E aceeași eroare ca la parametrii din URL?
Mesajul e asemănător, dar acolo apare la o cerere și dă 400. Aici apare la pornire, din configurare.
Erori înrudite
Could not resolve placeholder 'app.magazin.nume' in value "${app.magazin.nume}" Un @Value("${cheie}") cere o proprietate care nu există în application.properties (sau în profilul activ, în variabilele de mediu). Adaugă proprietatea, corectează numele cheii sau pune o valoare implicită: ${cheie:valoare}. Failed to bind properties under 'app.plati.timeout' to java.time.Duration Valoarea unei proprietăți legate cu @ConfigurationProperties nu se poate converti în tipul câmpului, aici o durată. Duration acceptă formatele 10s, 500ms, 2m, 1h sau ISO-8601 (PT10S), nu „10 sec”. Corectează valoarea din configurare. 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. Î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.
