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

Failed to bind properties under 'app.plati.timeout' to java.time.Duration

Pe scurt

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

Pentru 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

Greșit
JAVA
app.plati.timeout=10 sec
Corect
JAVA
app.plati.timeout=10s

Unitățile sunt prescurtate și lipite de număr.

2Valoare de enum necunoscută

Greșit
JAVA
app.plati.mod=rapid
enum Mod { STANDARD, EXPRES }
Corect
JAVA
app.plati.mod=expres

Pentru enum, Boot acceptă numele constantelor (indiferent de majuscule), nu alte cuvinte.

Repară tu

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.

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 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";
    }
}
După reparație, programul afișează
Tomcat started on port 8080 (http)
Started Application
GET /plati/timeout → 200
Timeout: 10 secunde
Indiciu

Unitatea se scrie prescurtat, lipită de număr.

Alte forme ale mesajului

  • Failed to bind properties under 'app.plati.mod' to Mod
  • Failed to bind properties under 'app.limita' to int

Cum o eviți pe viitor

  • Folosește Duration și DataSize pentru 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

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