Spring Boot健康监控核心是Actuator的/actuator/health端点，它聚合数据库、Redis等组件状态并支持自定义检查；需配置show-details: always才能显示完整诊断信息，返回分层JSON结构，且须注意生产环境的安全暴露策略。

Spring Boot 应用健康状态监控的核心是 Actuator 的 /actuator/health 端点，它不是简单返回“UP”或“DOWN”，而是聚合数据库、Redis、磁盘、自定义服务等组件的真实可用性。配置得当，它能在故障发生前就发出预警。

启用并暴露 health 端点

Actuator 默认只开放 /health 和 /info 两个端点，但仅暴露路径还不够——默认情况下，详细健康信息（比如哪个数据库连不上）只在本地显示。生产环境必须显式配置才能看到完整诊断数据：

• 在 application.yml 中添加：

  management:<br>  endpoint:<br>    health:<br>      show-details: always  # 关键：强制显示所有组件的检查详情<br>  endpoints:<br>    web:<br>      exposure:<br>        include: health,info  # 生产建议只开必要端点，避免敏感信息泄露

• 如果使用 application.properties，对应写为：
  management.endpoint.health.show-details=always
management.endpoints.web.exposure.include=health,info

理解 health 端点的返回结构

访问 http://localhost:8080/actuator/health 后，响应不是简单的布尔值，而是一个分层 JSON：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

• status 是聚合结果（如 UP 或 DOWN）
• components 下列出每个被检查项的状态，例如：
  

  "db": {"status": "UP", "details": {"database": "MySQL", "validationQuery": "isValid()"}}<br>"redis": {"status": "DOWN", "details": {"error": "Cannot connect to redis"}}

• 只要任一关键组件（如数据库）返回 DOWN，整体 status 就是 DOWN，便于告警系统快速判断

添加自定义健康检查逻辑

内置检查覆盖常见中间件，但业务强依赖的服务（如第三方支付网关、内部风控接口）需要自己写检查器：

• 实现 HealthIndicator 接口，例如检查订单服务是否能正常调用：

  @Component<br>public class OrderServiceHealthIndicator implements HealthIndicator {<br>    @Override<br>    public Health health() {<br>        try {<br>            // 模拟调用关键业务接口<br>            boolean ok = orderClient.ping();<br>            return ok ? Health.up().build() : Health.down().withDetail("reason", "order service unreachable").build();<br>        } catch (Exception e) {<br>            return Health.down().withException(e).build();<br>        }<br>    }<br>}

• 注册后，它会自动出现在 /actuator/health 的 components 中，名称默认为类名小写（orderServiceHealth）

安全与生产注意事项

health 端点虽属低敏感，但仍需防范信息泄露和滥用：

• 不要在生产环境开放 include: "*"，尤其禁用 env、beans、shutdown 等高危端点
• 通过 API 网关或反向代理限制访问 IP，或配合 Spring Security 做 Basic Auth / JWT 鉴权
• 若集成 Prometheus，推荐使用 /actuator/prometheus 替代 /metrics，格式更标准、性能更好