如何不暴露SpringBoot Actuator端点，自定义接口获取存活与就绪状态？

一、不暴露Actuator端点仍可使用HealthEndpoint #

设置management.endpoints.web.exposure.exclude=*只是禁止Actuator端点通过Web对外暴露，HealthEndpoint的Bean默认还是会被创建（只要management.endpoint.health.enabled=true，这是Spring Boot的默认配置）。你启动失败多半是误配了端点启用开关，或者依赖版本不兼容。

按以下步骤排查修复：

1. 确认配置文件中没有将management.endpoint.health.enabled设为false，默认开启的话无需额外配置
2. 直接注入HealthEndpoint编写自定义接口即可，示例代码：

@RestController
public class CustomHealthController {
    private final HealthEndpoint healthEndpoint;

    // 构造注入（推荐）
    public CustomHealthController(HealthEndpoint healthEndpoint) {
        this.healthEndpoint = healthEndpoint;
    }

    @GetMapping("/health")
    public Health getFullHealth() {
        return healthEndpoint.health();
    }
}

3. 若问题依旧，检查Actuator依赖版本与Spring Boot版本是否匹配（比如Spring Boot 3.x对应Actuator 3.x，2.x对应2.x）。

二、不依赖HealthEndpoint获取状态的替代方案 #

如果不想依赖HealthEndpoint，可以直接用Spring Boot提供的生命周期状态组件和健康指示器集合来实现需求：

1. 获取存活（Liveness）与就绪（Readiness）状态 #

从Spring Boot 2.3开始，框架提供了ApplicationAvailability来统一管理容器生命周期状态，直接注入这个Bean就能避免多个依赖注入冲突：

@RestController
public class LivenessReadinessController {
    private final ApplicationAvailability availability;

    public LivenessReadinessController(ApplicationAvailability availability) {
        this.availability = availability;
    }

    @GetMapping("/live")
    public Map<String, String> getLiveness() {
        LivenessState state = availability.getState(LivenessState.class, LivenessState.BROKEN);
        return Map.of("status", state.name());
    }

    @GetMapping("/ready")
    public Map<String, String> getReadiness() {
        ReadinessState state = availability.getState(ReadinessState.class, ReadinessState.REFUSING_TRAFFIC);
        return Map.of("status", state.name());
    }
}

2. 聚合所有健康指示器的状态 #

如果需要像HealthEndpoint那样返回完整的健康检查结果，不要直接注入单个HealthIndicator（会因为存在多个实现类导致注入失败），而是注入Collection<HealthIndicator>或者HealthContributorRegistry来获取所有健康组件：

@RestController
public class CustomHealthController {
    private final Collection<HealthIndicator> healthIndicators;
    private final HealthAggregator healthAggregator;

    public CustomHealthController(Collection<HealthIndicator> healthIndicators, HealthAggregator healthAggregator) {
        this.healthIndicators = healthIndicators;
        this.healthAggregator = healthAggregator;
    }

    @GetMapping("/health")
    public Health getAggregatedHealth() {
        Map<String, Health> indicatorHealths = new LinkedHashMap<>();
        healthIndicators.forEach(indicator -> 
            indicatorHealths.put(indicator.getClass().getSimpleName(), indicator.health())
        );
        return healthAggregator.aggregate(indicatorHealths);
    }
}

针对Spring Boot 3.x版本，HealthAggregator已被StatusAggregator替代，可调整代码为：

@RestController
public class CustomHealthController {
    private final Collection<HealthIndicator> healthIndicators;
    private final StatusAggregator statusAggregator;

    public CustomHealthController(Collection<HealthIndicator> healthIndicators, StatusAggregator statusAggregator) {
        this.healthIndicators = healthIndicators;
        this.statusAggregator = statusAggregator;
    }

    @GetMapping("/health")
    public Health getAggregatedHealth() {
        Map<String, Health> indicatorHealths = new LinkedHashMap<>();
        healthIndicators.forEach(indicator -> 
            indicatorHealths.put(indicator.getClass().getSimpleName(), indicator.health())
        );
        
        Status aggregatedStatus = statusAggregator.getAggregateStatus(
            indicatorHealths.values().stream().map(Health::getStatus).toList()
        );
        return Health.status(aggregatedStatus).withDetails(indicatorHealths).build();
    }
}

三、核心配置要点 #

• management.endpoints.web.exposure.exclude=*仅控制Web暴露，不会禁用Actuator内部的健康组件，不要修改management.endpoint.health.enabled为false，否则相关Bean会被销毁
• 若自定义了HealthIndicator，确保其实现类被Spring容器扫描到，否则不会被纳入聚合结果

内容的提问来源于stack exchange，提问作者Maxime B