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}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
${app.magazin.nume} este un placeholder: Spring îl înlocuiește la pornire cu valoarea proprietății app.magazin.nume, căutată în application.properties / application.yml, în fișierul profilului activ, în variabilele de mediu și în argumentele din linia de comandă. Dacă nu o găsește nicăieri și placeholder-ul nu are valoare implicită, bean-ul nu se poate crea și aplicația se oprește cu Could not resolve placeholder 'app.magazin.nume' in value "${app.magazin.nume}".
Prima parte a mesajului îți dă cheia exactă care lipsește, a doua textul complet din adnotare (util când placeholder-ul e compus, de exemplu "Salut, ${app.nume}!").
Cauzele frecvente sunt o greșeală de scriere (app.magazine.nume), proprietatea pusă doar în fișierul unui profil care nu e activ, sau un fișier YAML cu indentare greșită, care mută cheia în alt loc.
De ce apare: cauzele frecvente
1Proprietatea lipsește sau e scrisă altfel
# application.properties
app.magazin.denumire=Librăria Ana
@Value("${app.magazin.nume}") String nume;# application.properties
app.magazin.nume=Librăria Ana
@Value("${app.magazin.nume}") String nume;Cheia din @Value trebuie să existe exact așa în configurare.
2Proprietatea e doar într-un profil inactiv
# application-dev.properties
app.magazin.nume=Test
# niciun profil activ# application.properties
app.magazin.nume=Librăria AnaFișierul application-dev.properties se citește doar când profilul dev e activ. Valorile comune stau în application.properties.
3Proprietatea e opțională, dar n-are valoare implicită
@Value("${app.banner.text}") String banner;@Value("${app.banner.text:}") String banner;După : urmează valoarea implicită (aici textul gol), folosită când cheia lipsește.
Repară eroarea, direct în pagină
Aplicația nu pornește: Could not resolve placeholder 'app.magazin.nume'. În application.properties există o cheie cu nume asemănător. Corectează cheia din @Value ca GET /despre să răspundă Librăria Ana, iar ruta GET /banner să răspundă textul gol când app.banner.text lipsește.
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 DespreController {
@Value("${app.magazin.nume}")
String nume;
@Value("${app.banner.text}")
String banner;
@GetMapping("/despre")
String despre() {
return nume;
}
@GetMapping("/banner")
String banner() {
return "[" + banner + "]";
}
}Tomcat started on port 8080 (http) Started Application GET /despre → 200 Librăria Ana GET /banner → 200 []
Indiciu
Compară cheia din @Value cu cea din fișier; pentru banner folosește o valoare implicită goală.
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 DespreController {
@Value("${app.magazin.denumire}")
String nume;
@Value("${app.banner.text:}")
String banner;
@GetMapping("/despre")
String despre() {
return nume;
}
@GetMapping("/banner")
String banner() {
return "[" + banner + "]";
}
}De ce merge
Placeholder-ul trebuie să numească exact o cheie existentă: în fișier era app.magazin.denumire, nu app.magazin.nume. Pentru app.banner.text, care chiar lipsește, ${app.banner.text:} spune „dacă nu există, folosește textul gol”, așa că pornirea nu mai depinde de ea. Ruta afișează []. Folosește valori implicite doar pentru proprietățile cu adevărat opționale: pentru cele obligatorii e mai bine ca aplicația să nu pornească.
Alte forme ale mesajului
java.lang.IllegalArgumentException: Could not resolve placeholder 'DB_PASSWORD' in value "${DB_PASSWORD}"
Cum o eviți pe viitor
- Ține toate proprietățile proprii sub un prefix comun (
app.), ca să le găsești ușor. - Pune valorile comune în
application.properties, iar în fișierele de profil doar diferențele. - Dă valori implicite proprietăților opționale:
${app.x:valoare}. - Pentru grupuri de setări, folosește
@ConfigurationProperties: primești erori de legare clare și completare în IDE.
Întrebări frecvente
Cum dau proprietatea din linia de comandă?
java -jar app.jar --app.magazin.nume=Ana sau ca variabilă de mediu APP_MAGAZIN_NUME=Ana. Spring le găsește pe toate.
De ce merge în IntelliJ și nu pe server?
De obicei proprietatea vine dintr-o variabilă de mediu sau dintr-un profil setat în configurarea de rulare din IDE, care nu există pe server.
Erori înrudite
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. No active profile set, falling back to 1 default profile: "default" Mesajul INFO de la pornire spune că niciun profil nu e activ, deci Spring folosește doar application.properties și ignoră application-dev.properties. Nu e o eroare; dacă ai nevoie de un profil, activează-l cu spring.profiles.active=dev. Parameter 0 of constructor in EmailService required a bean of type 'java.lang.String' that could not be found. Constructorul unui bean are un parametru simplu (String, int), iar Spring încearcă să-l injecteze ca bean. Valorile de configurare se dau cu @Value("${cheie}") pe parametru sau prin @ConfigurationProperties, nu ca bean-uri. Î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.
