GET /actuator/health → 503 {"status":"DOWN"}
Cel puțin un HealthIndicator (bază de date, disc, un serviciu extern sau unul scris de tine) raportează DOWN, deci starea totală e DOWN, iar răspunsul are codul 503. Activează show-details ca să vezi componenta problematică, apoi repar-o (de obicei configurarea).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
/actuator/health combină starea tuturor bean-urilor HealthIndicator: db (conexiunea la bază), diskSpace, ping, plus indicatorii proprii. Dacă unul raportează DOWN, starea totală devine DOWN, iar endpoint-ul răspunde cu codul 503 Service Unavailable. Load balancer-ele și Kubernetes (readiness/liveness) folosesc exact acest cod, deci o instanță DOWN nu mai primește trafic sau e repornită.
Implicit, răspunsul conține doar {"status":"DOWN"}, fără motiv. Cu management.endpoint.health.show-details=always (local) sau when-authorized (producție) vezi fiecare componentă, cu detaliile ei, de exemplu "furnizor":{"status":"DOWN","details":{"motiv":"URL lipsă"}}.
Cauzele tipice: baza de date nu răspunde sau are credențiale greșite, discul aproape plin, un serviciu extern căzut sau o proprietate necesară unui indicator propriu, scrisă greșit.
De ce apare: cauzele frecvente
1Proprietate scrisă greșit pentru un indicator
app.furnizor-url=https://furnizor.example
# indicatorul citește app.furnizor.urlapp.furnizor.url=https://furnizor.exampleCheia trebuie să fie exact cea citită de indicator.
2Baza de date indisponibilă
spring.datasource.password=parola-veche
# db: DOWNspring.datasource.password=${DB_PASSWORD}Indicatorul db încearcă o conexiune reală; credențialele greșite îl fac DOWN.
Repară eroarea, direct în pagină
GET /actuator/health răspunde 503 DOWN. Detaliile arată că indicatorul furnizor nu găsește URL-ul furnizorului, deși configurarea îl conține. Rescrie application.properties în cod (comentariu /* application.properties ... */), păstrând celelalte chei și corectând cheia URL-ului, ca starea să devină UP.
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.actuate.health.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Component
class FurnizorHealthIndicator implements HealthIndicator {
private final String url;
FurnizorHealthIndicator(@Value("${app.furnizor.url:}") String url) {
this.url = url;
}
@Override
public Health health() {
if (url.isBlank()) {
return Health.down().withDetail("motiv", "URL lipsă").build();
}
return Health.up().withDetail("url", url).build();
}
}
/* application.properties
management.endpoint.health.show-details=always
app.furnizor-url=https://furnizor.example
*/Tomcat started on port 8080 (http)
Started Application
GET /actuator/health → 200
{"status":"UP","components":{"furnizor":{"status":"UP","details":{"url":"https://furnizor.example"}},"ping":{"status":"UP"}}}Indiciu
Compară cheia din @Value cu cea din application.properties: punct vs liniuță.
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.actuate.health.*;
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@Component
class FurnizorHealthIndicator implements HealthIndicator {
private final String url;
FurnizorHealthIndicator(@Value("${app.furnizor.url:}") String url) {
this.url = url;
}
@Override
public Health health() {
if (url.isBlank()) {
return Health.down().withDetail("motiv", "URL lipsă").build();
}
return Health.up().withDetail("url", url).build();
}
}
/* application.properties
management.endpoint.health.show-details=always
app.furnizor.url=https://furnizor.example
*/De ce merge
Indicatorul citea app.furnizor.url, dar configurarea avea app.furnizor-url, o cheie diferită. Valoarea implicită goală l-a făcut să raporteze DOWN, iar o singură componentă DOWN face starea totală DOWN, cu codul 503. Cu cheia corectă, indicatorul primește URL-ul și raportează UP. show-details=always a arătat exact componenta și motivul.
Alte forme ale mesajului
{"status":"OUT_OF_SERVICE"}"db":{"status":"DOWN","details":{"error":"org.springframework.jdbc.CannotGetJdbcConnectionException"}}"diskSpace":{"status":"DOWN"}
Cum o eviți pe viitor
- Activează detaliile health în mediile de test, ca să vezi imediat componenta DOWN.
- Folosește grupuri separate pentru liveness și readiness (
management.endpoint.health.group.*), ca o dependență externă căzută să nu repornească aplicația. - Scrie indicatori proprii care întorc detalii clare la DOWN.
- Verifică health în pipeline după fiecare deploy.
Întrebări frecvente
De ce 503 și nu 200 cu DOWN?
Spring Boot mapează DOWN și OUT_OF_SERVICE la 503, ca load balancer-ele să poată reacționa doar după cod.
Pot ascunde un indicator din health?
Da, cu management.health.<nume>.enabled=false, dar fă asta doar dacă dependența chiar nu contează pentru disponibilitatea aplicației.
Erori înrudite
GET /actuator/info → 404 No static resource actuator/info. Endpoint-ul Actuator există, dar nu este expus prin HTTP: implicit, Spring Boot expune doar /actuator/health. Adaugă endpoint-ul în management.endpoints.web.exposure.include (și, pentru /info, activează sursa de date, de exemplu management.info.env.enabled=true). 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}. 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. Î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.
