...
Eroare Spring Boot · Configurare, proprietăți și profiluri

Could not resolve placeholder 'app.magazin.nume' in value "${app.magazin.nume}"

Pe scurt

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

Greșit
JAVA
# application.properties
app.magazin.denumire=Librăria Ana

@Value("${app.magazin.nume}") String nume;
Corect
JAVA
# 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

Greșit
JAVA
# application-dev.properties
app.magazin.nume=Test
# niciun profil activ
Corect
JAVA
# application.properties
app.magazin.nume=Librăria Ana

Fiș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ă

Greșit
JAVA
@Value("${app.banner.text}") String banner;
Corect
JAVA
@Value("${app.banner.text:}") String banner;

După : urmează valoarea implicită (aici textul gol), folosită când cheia lipsește.

Repară tu

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.

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

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

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