.NET中的健康检查(Health Checks)是什么？如何在微服务中实现它？

.NET健康检查通过/health端点监控服务状态，支持数据库、Redis等依赖检测，结合Kubernetes探针实现自动流量管理与容器重启，提升微服务稳定性。

.NET中的健康检查（Health Checks）是一种用于监控应用程序运行状态的机制，帮助外部系统（如负载均衡器、Kubernetes 或服务网格）判断某个服务实例是否正常运行。它不只检查应用是否启动，还能检测其依赖项（如数据库、缓存、消息队列等）是否可用。

健康检查的基本原理

健康检查通常通过一个公开的HTTP端点（如 /health）暴露服务状态。该端点返回一个简短的状态信息，常见状态包括：

• Healthy：所有组件正常
• Degraded：部分非核心组件异常，但服务仍可运行
• Unhealthy：关键组件故障，服务不可用

Kubernetes 等编排工具会定期调用这个接口，自动决定是否将流量路由到该实例或重启容器。

在微服务中启用健康检查

在 .NET（尤其是 ASP.NET Core）中，可以通过 Microsoft.Extensions.Diagnostics.HealthChecks 包实现健康检查功能。以下是具体步骤：

1. 安装 NuGet 包（如果使用第三方检查）

例如，检查 SQL Server：

Install-Package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore

2. 在 Program.cs 中注册健康检查服务

示例代码：

builder.Services.AddHealthChecks()
    .AddDbContextCheck() // 检查数据库上下文
    .AddRedis("redisConnectionString", name: "redis") // 检查 Redis
    .AddUrlGroup(new Uri("https://api.external.com/health"), name: "external-api");

// 启用健康检查中间件
app.MapHealthChecks("/health");
app.MapHealthChecks("/health-details", new HealthCheckOptions()
{
    ResponseWriter = WriteDetailedResponse // 输出详细信息（谨慎用于生产）
});

3. 配置不同环境的暴露策略

生产环境建议只暴露简洁状态，避免泄露敏感信息。调试环境可开启详细输出：

static Task WriteDetailedResponse(HttpContext context, HealthReport report)
{
    context.Response.ContentType = "application/json";
    var response = new
    {
        Status = report.Status,
        Checks = report.Entries.Select(e => new
        {
            e.Key,
            e.Value.Status,
            e.Value.Description
        })
    };
    return context.Response.WriteAsJsonAsync(response);
}

与 Kubernetes 集成

在 Kubernetes 中，可通过 liveness 和 readiness 探针使用健康检查端点：

livenessProbe:
  httpGet:
    path: /health
    port: 80
  initialDelaySeconds: 30
  periodSeconds: 10

readinessProbe:
  httpGet:
    path: /health
    port: 80
  initialDelaySeconds: 5
  periodSeconds: 5

• liveness：判断容器是否存活，失败则重启 Pod
• readiness：判断是否准备好接收流量，失败则从服务端点移除

自定义健康检查逻辑

对于特定业务逻辑，可以实现自定义检查：

public class CustomHealthCheck : IHealthCheck
{
    public async Task CheckHealthAsync(HealthCheckContext context, CancellationToken cancellationToken = default)
    {
        // 自定义逻辑：比如检查磁盘空间、外部服务凭证等
        var isHealthy = await SomeBusinessCondition();
        if (isHealthy)
            return HealthCheckResult.Healthy("Custom check passed.");
        
        return HealthCheckResult.Unhealthy("Custom check failed.");
    }
}

注册时使用：

services.AddHealthChecks().AddCheck("custom");

基本上就这些。.NET 的健康检查机制轻量、灵活，非常适合微服务架构中的可观测性需求。合理配置后，能显著提升系统的稳定性和运维效率。