在Spring Boot中自定义数据库健康检查需实现HealthIndicator接口，用JdbcTemplate执行SELECT 1并设超时，成功返回Health.up()、失败返回Health.down()并附错误详情；同时需禁用默认DataSourceHealthIndicator，如通过exclude自动配置或配置management.health.defaults.enabled=false。
在 Spring Boot 中，可以通过实现 HealthIndicator 接口来自定义数据库连接健康检查，替代默认的 DataSourceHealthIndicator（它只简单尝试获取连接，不执行实际 SQL），从而更精准地判断数据库是否真正可用。
创建自定义 HealthIndicator 实现类
新建一个类，实现 HealthIndicator 接口，重写 health() 方法。推荐使用 JdbcTemplate 执行轻量级 SQL（如 SELECT 1）来验证连接有效性：
- 注入
JdbcTemplate或DataSource（推荐前者，避免手动管理连接） - 在
health()中执行查询；成功则返回Health.up().build()，失败则用Health.down()并附带异常信息 - 建议设置超时（如通过
SimpleJdbcCall不适用，应改用JdbcTemplate.queryForObject配合setQueryTimeout）
示例代码：
@Component("customDbHealthIndicator")
public class CustomDbHealthIndicator implements HealthIndicator {
private final JdbcTemplate jdbcTemplate;
public CustomDbHealthIndicator(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Override
public Health health() {
try {
// 设置查询超时为 3 秒，防止挂起
Integer result = jdbcTemplate.queryForObject("SELECT 1", Integer.class);
return Health.up()
.withDetail("query", "SELECT 1")
.withDetail("result", result)
.build();
} catch (Exception e) {
return Health.down()
.withDetail("error", e.getMessage())
.withDetail("timestamp", System.currentTimeMillis())
.build();
}
}
}
禁用默认 DataSourceHealthIndicator
Spring Boot 默认会自动配置 DataSourceHealthIndicator。若启用自定义实现，需显式关闭默认项，否则 /actuator/health 会同时显示两个数据库健康状态：
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
- 在
application.yml中添加：management.health.db.show-details: never（可选，控制细节可见性） - 更关键的是：设置
management.health.defaults.enabled: false，再单独启用自定义指标 - 或直接排除自动配置：
@SpringBootApplication(exclude = {DataSourceHealthContributorAutoConfiguration.class})
注册为 HealthContributor（Spring Boot 2.2+ 推荐方式）
从 Spring Boot 2.2 开始，HealthIndicator 已被标记为过时，推荐实现 HealthContributor 的子接口 HealthIndicator 仍可用，但更规范的做法是确保 Bean 名以 HealthIndicator 结尾，或显式使用 @Endpoint 风格扩展 —— 实际项目中继续用 HealthIndicator 实现类 + @Component 即可被自动发现。
- Bean 名建议含
HealthIndicator后缀（如customDbHealthIndicator），Spring Boot 会自动识别 - 无需额外注册，只要类在组件扫描路径下且是
@Component，就会被HealthEndpoint自动收集 - 可通过
management.endpoint.health.show-details=always查看详细信息
验证与调试
启动应用后访问 http://localhost:8080/actuator/health（或 /actuator/health/db 如果指定了 group），观察响应内容：
- 正常时状态为
"status": "UP"，并包含你写的details - 断开数据库后应变为
"status": "DOWN"，且details中有错误描述 - 如未出现，检查类是否被扫描、是否与其他
HealthIndicator冲突、日志是否有Health contribution注册记录
