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

Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'app.paginare' to PaginareProps failed

Pe scurt

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 100

Property 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

Greșit
JAVA
app.paginare.marime=500

@Validated
@ConfigurationProperties(prefix = "app.paginare")
record PaginareProps(@Max(100) int marime) { }
Corect
JAVA
app.paginare.marime=50

Regula @Max(100) e intenționată; valoarea trebuie adusă în interval.

2O proprietate obligatorie lipsește

Greșit
JAVA
# lipsește app.mail.expeditor
record MailProps(@NotBlank String expeditor) { }
Corect
JAVA
app.mail.expeditor=comenzi@exemplu.ro

Lipsa valorii o face null, iar @NotBlank o respinge cu Reason: must not be blank.

Repară tu

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.

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

Alte forme ale mesajului

  • Reason: must be greater than or equal to 1
  • Reason: 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

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