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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
La legarea unei clase @ConfigurationProperties, Spring Boot convertește fiecare proprietate în tipul câmpului. Dacă nu reușește, oprește pornirea cu un raport:
Failed to bind properties under 'app.plati.timeout' to java.time.Duration:
Property: app.plati.timeout
Value: "10 sec"
Origin: class path resource [application.properties] - 1:19
Reason: failed to convert java.lang.String to java.time.DurationPentru Duration, Boot acceptă un număr urmat de o unitate scurtă, fără spațiu: ns, us, ms, s, m, h, d (de exemplu 10s, 500ms), un număr simplu (interpretat ca milisecunde, sau unitatea din @DurationUnit) sau formatul ISO-8601 (PT10S). Același raport apare pentru orice tip: int, boolean, enum, DataSize, liste. Partea to <tip> îți spune tipul așteptat, iar Value textul primit.
De ce apare: cauzele frecvente
1Unitate scrisă greșit
app.plati.timeout=10 secapp.plati.timeout=10sUnitățile sunt prescurtate și lipite de număr.
2Valoare de enum necunoscută
app.plati.mod=rapid
enum Mod { STANDARD, EXPRES }app.plati.mod=expresPentru enum, Boot acceptă numele constantelor (indiferent de majuscule), nu alte cuvinte.
Repară eroarea, direct în pagină
PlatiProps are un câmp Duration timeout, iar configurarea conține app.plati.timeout=10 sec. Aplicația nu pornește. Rescrie application.properties în cod (comentariu bloc) cu durata în formatul acceptat de Spring Boot, ca GET /plati/timeout să răspundă Timeout: 10 secunde.
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 java.time.Duration;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@ConfigurationProperties(prefix = "app.plati")
record PlatiProps(Duration timeout) {
}
@Configuration
@EnableConfigurationProperties(PlatiProps.class)
class ConfigPlati {
}
@RestController
class PlatiController {
private final PlatiProps props;
PlatiController(PlatiProps props) {
this.props = props;
}
@GetMapping("/plati/timeout")
String timeout() {
return "Timeout: " + props.timeout().getSeconds() + " secunde";
}
}Tomcat started on port 8080 (http) Started Application GET /plati/timeout → 200 Timeout: 10 secunde
Indiciu
Unitatea se scrie prescurtat, lipită de număr.
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 java.time.Duration;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@ConfigurationProperties(prefix = "app.plati")
record PlatiProps(Duration timeout) {
}
@Configuration
@EnableConfigurationProperties(PlatiProps.class)
class ConfigPlati {
}
@RestController
class PlatiController {
private final PlatiProps props;
PlatiController(PlatiProps props) {
this.props = props;
}
@GetMapping("/plati/timeout")
String timeout() {
return "Timeout: " + props.timeout().getSeconds() + " secunde";
}
}
/* application.properties
app.plati.timeout=10s
*/De ce merge
10 sec nu e un format cunoscut de convertorul de durate, așa că legarea eșuează și Boot oprește pornirea cu proprietatea și valoarea exactă. 10s (sau PT10S) este interpretat corect ca zece secunde. Tipul Duration e alegerea bună pentru timeout-uri: în cod nu mai calculezi milisecunde de mână, iar configurarea rămâne lizibilă.
Alte forme ale mesajului
Failed to bind properties under 'app.plati.mod' to ModFailed to bind properties under 'app.limita' to int
Cum o eviți pe viitor
- Folosește
DurationșiDataSizepentru timpi și dimensiuni, cu unități explicite (10s,5MB). - Documentează formatul în comentariul de lângă proprietate.
- Scrie un test care pornește contextul cu configurarea de producție, ca o valoare greșită să fie prinsă înainte de deploy.
Întrebări frecvente
Ce înseamnă un număr fără unitate?
Pentru Duration, milisecunde, dacă nu ai pus @DurationUnit(ChronoUnit.SECONDS) pe câmp. Ca să eviți confuzia, scrie mereu unitatea.
Pot folosi și formatul ISO?
Da, PT10S înseamnă 10 secunde, PT1M30S un minut și jumătate.
Erori înrudite
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. 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. 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. Î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.
