SpringBoot 2.7.12中Liveness/Readiness状态未随配置更新异常

问题场景 #

在application.properties中添加以下健康分组配置后：

management.endpoint.health.group.liveness.include=livenessState,db
management.endpoint.health.group.readiness.include=readinessState,db

手动关闭数据库后，整体健康状态返回DOWN（符合预期），但livenessState组件仍显示UP、readinessState显示ACCEPTING_TRAFFIC（不符合预期）。

健康检查返回结果：

{"status": "DOWN","components": {"db": {"status": "DOWN","components": {"mainDb": {"status": "DOWN","details": {"error": "org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to obtain JDBC Connection; nested exception is java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available, request timed out after 30002ms."}},"streamingDs": {"status": "DOWN","details": {"error": "org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to obtain JDBC Connection; nested exception is java.sql.SQLTransientConnectionException: HikariPool-2 - Connection is not available, request timed out after 30001ms."}}},"livenessState": {"status": "UP"}}}

原因解析 #

1. 组件状态与分组状态的区别：
   • livenessState和readinessState是Spring Boot内置的独立状态指示器：
     • livenessState默认仅关注应用自身是否存活（如是否发生死锁、无法完成启动），数据库不可达属于外部依赖故障，默认不会触发其状态变为DOWN。
     • readinessState默认关注应用是否准备好接收流量，但当前配置是将readinessState组件和db组件加入readiness分组，分组的状态是所有包含组件的聚合结果，但readinessState组件自身的默认逻辑不会关联db状态。
2. 端点访问误区：
   • 若访问的是根健康端点/actuator/health，返回的是所有组件的原始状态，而非分组的聚合状态。需访问分组专属端点（/actuator/health/liveness、/actuator/health/readiness）才能看到分组的聚合结果。

解决方案 #

方案1：正确使用分组端点 #

确保已配置端点暴露：

management.endpoints.web.exposure.include=health
management.endpoint.health.show-details=always

访问分组端点查看聚合状态：

• 存活状态：GET /actuator/health/liveness（此时会聚合livenessState和db的状态，返回DOWN）
• 就绪状态：GET /actuator/health/readiness（聚合readinessState和db的状态，返回DOWN）

方案2：调整分组配置，直接关联依赖状态 #

若希望分组状态完全由数据库状态决定，可移除livenessState/readinessState的包含，仅保留db：

management.endpoint.health.group.liveness.include=db
management.endpoint.health.group.readiness.include=db

此时分组状态将直接跟随db的状态变化，数据库不可达时，两个分组的状态都会变为DOWN。

方案3：自定义存活/就绪判断逻辑 #

若需要将数据库状态纳入livenessState的判断，可自定义LivenessStateHealthIndicator：

@Component
public class CustomLivenessIndicator implements LivenessStateHealthIndicator {

    private final HealthIndicator dbHealthIndicator;

    public CustomLivenessIndicator(HealthIndicator dbHealthIndicator) {
        this.dbHealthIndicator = dbHealthIndicator;
    }

    @Override
    public Health health() {
        Health dbHealth = dbHealthIndicator.health();
        if (dbHealth.getStatus() == Status.DOWN) {
            return Health.down().withDetail("reason", "Database is unavailable").build();
        }
        return Health.up().build();
    }
}

同理可自定义ReadinessStateHealthIndicator来关联数据库状态。

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