Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'app.paginare' to PaginareProps failed
O clasă @ConfigurationProperties marcată cu @Validated a primit din configurare o valoare care încalcă o regulă (@Min, @Max, @NotBlank). Mesajul arată proprietatea, valoarea și motivul (Reason): corectează valoarea din application.properties.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Spring Boot leagă proprietățile cu un prefix comun (app.paginare.*) de o clasă sau un record @ConfigurationProperties. Cu @Validated, după legare rulează și validarea Bean Validation. Dacă o valoare încalcă o regulă, pornirea se oprește cu un raport foarte precis:
Binding to target PaginareProps failed:
Property: app.paginare.marime
Value: "500"
Origin: class path resource [application.properties] - 1:22
Reason: must be less than or equal to 100Property este cheia, Value valoarea citită, Origin fișierul și poziția (linia:coloana) de unde vine, iar Reason regula încălcată, cu mesajul implicit al validatorului. Este exact ce vrei pentru configurare: o valoare greșită oprește aplicația la pornire, nu produce comportamente ciudate după o zi în producție.
De ce apare: cauzele frecvente
1Valoarea din fișier încalcă regula
app.paginare.marime=500
@Validated
@ConfigurationProperties(prefix = "app.paginare")
record PaginareProps(@Max(100) int marime) { }app.paginare.marime=50Regula @Max(100) e intenționată; valoarea trebuie adusă în interval.
2O proprietate obligatorie lipsește
# lipsește app.mail.expeditor
record MailProps(@NotBlank String expeditor) { }app.mail.expeditor=comenzi@exemplu.roLipsa valorii o face null, iar @NotBlank o respinge cu Reason: must not be blank.
Repară eroarea, direct în pagină
PaginareProps acceptă o mărime de pagină de cel mult 100, dar application.properties are app.paginare.marime=500, iar aplicația nu pornește: Binding to target PaginareProps failed. Păstrează regula și corectează configurarea (scrie fișierul în cod ca comentariu /* application.properties ... */) la 50, ca GET /setari să răspundă Pagini de 50.
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.*;
import org.springframework.boot.context.properties.*;
import org.springframework.context.annotation.*;
import org.springframework.validation.annotation.Validated;
import jakarta.validation.constraints.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Validated
@ConfigurationProperties(prefix = "app.paginare")
record PaginareProps(@Min(1) @Max(100) int marime) {
}
@Configuration
@EnableConfigurationProperties(PaginareProps.class)
class ConfigProprietati {
}
@RestController
class SetariController {
private final PaginareProps props;
SetariController(PaginareProps props) {
this.props = props;
}
@GetMapping("/setari")
String setari() {
return "Pagini de " + props.marime();
}
}Tomcat started on port 8080 (http) Started Application GET /setari → 200 Pagini de 50
Indiciu
Fișierul din comentariul bloc are prioritate față de cel din proiect.
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.*;
import org.springframework.boot.context.properties.*;
import org.springframework.context.annotation.*;
import org.springframework.validation.annotation.Validated;
import jakarta.validation.constraints.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Validated
@ConfigurationProperties(prefix = "app.paginare")
record PaginareProps(@Min(1) @Max(100) int marime) {
}
@Configuration
@EnableConfigurationProperties(PaginareProps.class)
class ConfigProprietati {
}
@RestController
class SetariController {
private final PaginareProps props;
SetariController(PaginareProps props) {
this.props = props;
}
@GetMapping("/setari")
String setari() {
return "Pagini de " + props.marime();
}
}
/* application.properties
app.paginare.marime=50
*/De ce merge
Mesajul a spus totul: proprietatea app.paginare.marime, valoarea 500, fișierul și motivul must be less than or equal to 100. Regula este corectă (o pagină de 500 de rânduri ar încărca inutil serverul), deci se repară valoarea. În proiect modifici src/main/resources/application.properties; aici comentariul bloc ține locul fișierului. Aplicația pornește, iar PaginareProps primește 50.
Alte forme ale mesajului
Reason: must be greater than or equal to 1Reason: must not be blank
Cum o eviți pe viitor
- Pune reguli de validare pe proprietățile importante: o greșeală se vede la pornire.
- Ține valorile implicite rezonabile direct în cod sau în
application.properties, iar profilurile să suprascrie doar ce diferă. - Citește
Origin: îți spune fișierul exact, util când aceeași cheie apare în mai multe surse (profil, variabile de mediu).
Întrebări frecvente
Ce înseamnă 1:22 din Origin?
Linia 1, coloana 22 din fișierul indicat, adică locul unde începe valoarea greșită.
Funcționează validarea fără @Validated?
Nu. Fără @Validated pe clasa de proprietăți, adnotările @Min, @NotBlank sunt ignorate la legare.
Erori înrudite
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. Not registered via @EnableConfigurationProperties, marked as Spring component, or scanned via @ConfigurationPropertiesScan Clasa @ConfigurationProperties nu este înregistrată ca bean, deci nu poate fi injectată (la pornire vezi „required a bean of type ... that could not be found”). Adaugă @EnableConfigurationProperties(Clasa.class) sau @ConfigurationPropertiesScan pe clasa aplicației. 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}. Î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.
