GET /actuator/info → {}
Endpoint-ul /actuator/info e expus, dar răspunde un obiect gol, deși ai proprietăți info.* în application.properties. Din Spring Boot 2.6 contribuția din proprietăți e dezactivată implicit: pune management.info.env.enabled=true (sau adaugă build-info / git-info).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
/actuator/info adună informații de la mai mulți „contributori”: proprietățile info.* din configurare (env), informațiile de build (build, din META-INF/build-info.properties), cele din Git (git), Java și sistemul de operare. Fiecare contributor are propriul comutator management.info.<nume>.enabled.
Începând cu Spring Boot 2.6, contributorul env este dezactivat implicit. De aceea, după o actualizare sau urmând un tutorial vechi, scrii info.app.nume=Magazin și primești doar {}. Endpoint-ul funcționează (răspunde 200), doar că nimeni nu-i dă date.
Nu confunda cu 404 pe /actuator/info: acela înseamnă că endpoint-ul nu e expus prin management.endpoints.web.exposure.include. Aici expunerea e corectă, lipsește doar sursa datelor.
De ce apare: cauzele frecvente
1Contributorul env este dezactivat
management.endpoints.web.exposure.include=health,info
info.app.nume=Magazin onlinemanagement.endpoints.web.exposure.include=health,info
management.info.env.enabled=true
info.app.nume=Magazin onlineDin Boot 2.6, proprietățile info.* apar doar după ce activezi contributorul env.
2Vrei versiunea aplicației din build
info.app.versiune=1.4.0 # scrisă de mână<!-- pom.xml, spring-boot-maven-plugin -->
<executions><execution><goals>
<goal>build-info</goal>
</goals></execution></executions>Goal-ul build-info generează fișierul din care contributorul build citește versiunea, fără să o scrii de mână.
3Cheile nu încep cu info.
app.nume=Magazin onlineinfo.app.nume=Magazin onlineContributorul env publică doar proprietățile al căror nume începe cu info..
Repară eroarea, direct în pagină
/actuator/info este expus, dar răspunde {}, deși în application.properties (comentariul de sus) ai info.app.nume și info.app.versiune. Activează contribuția proprietăților, ca răspunsul să fie {"app":{"nume":"Magazin online","versiune":"1.4.0"}}.
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
/* application.properties
management.endpoints.web.exposure.include=health,info
info.app.nume=Magazin online
info.app.versiune=1.4.0
# TODO: /actuator/info răspunde {} până nu activezi contribuția din proprietăți
*/
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut!";
}
}Tomcat started on port 8080 (http)
Started Application
GET /actuator/info → 200
{"app":{"nume":"Magazin online","versiune":"1.4.0"}}Indiciu
Proprietatea are forma management.info.<contributor>.enabled.
Reparația
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.*;
/* application.properties
management.endpoints.web.exposure.include=health,info
info.app.nume=Magazin online
info.app.versiune=1.4.0
management.info.env.enabled=true
*/
@SpringBootApplication
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
@RestController
class SalutController {
@GetMapping("/salut")
String salut() {
return "Salut!";
}
}De ce merge
Endpoint-ul era expus, dar contributorul env, care publică proprietățile info.*, este dezactivat implicit din Spring Boot 2.6. Cu management.info.env.enabled=true, Actuator citește toate cheile care încep cu info. și le întoarce ca JSON imbricat după punct: info.app.nume devine {"app":{"nume":...}}. Expunerea endpoint-ului și activarea contributorilor sunt două setări separate.
Cum o eviți pe viitor
- Când expui
/actuator/info, activează explicit contributorii de care ai nevoie (env,build,git,java). - Generează versiunea din build (
build-info), nu o scrie de mână. - Verifică endpoint-urile Actuator după fiecare actualizare de versiune Spring Boot.
- Nu pune în
info.*date sensibile: endpoint-ul este adesea public.
Întrebări frecvente
De ce Spring a dezactivat proprietățile info implicit?
Ca să nu publice din greșeală date de configurare. Acum alegi explicit ce contributori sunt activi.
Pot adăuga informații din cod?
Da: un bean care implementează InfoContributor poate pune orice valori calculate (număr de produse, starea unui serviciu extern) în răspunsul /actuator/info.
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). 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). 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.
