ASP.NET Core健康检查入门指南（轻松实现应用健康状态监控）

什么是 ASP.NET Core 健康检查？

ASP.NET Core 健康检查是 .NET Core 内置的一项功能，允许你通过 HTTP 端点暴露应用程序的“健康状态”。当系统或运维人员调用该端点时，应用会执行一系列预定义的检查（例如连接数据库、调用第三方 API），并返回一个 JSON 或纯文本响应，说明当前是否“健康”（Healthy）、“降级”（Degraded）或“不健康”（Unhealthy）。

这项功能对于容器化部署（如 Docker + Kubernetes）尤其有用，Kubernetes 可以根据健康检查结果自动重启故障容器，从而提升系统可靠性。

第一步：创建 ASP.NET Core 项目

首先，确保你已安装 .NET SDK（建议使用 .NET 6 或更高版本）。打开终端，运行以下命令创建一个新项目：

dotnet new webapi -n MyHealthCheckAppcd MyHealthCheckApp

第二步：添加健康检查服务

ASP.NET Core 的健康检查功能由 Microsoft.Extensions.Diagnostics.HealthChecks 提供。幸运的是，从 .NET Core 2.2 起，它已内置，无需额外安装 NuGet 包。

打开 Program.cs 文件（如果你使用的是 .NET 6+ 的最小 API 模板），添加健康检查服务：

var builder = WebApplication.CreateBuilder(args);// 添加健康检查服务builder.Services.AddHealthChecks();var app = builder.Build();// 配置健康检查终结点app.MapHealthChecks("/health");app.Run();

现在，当你运行应用并访问 http://localhost:5000/health（端口可能不同），你会看到页面显示 “Healthy” —— 这就是最基础的健康检查！

第三步：添加自定义健康检查（例如数据库）

真实场景中，我们通常需要检查数据库、缓存、外部 API 等依赖项。下面以 SQL Server 为例，演示如何添加数据库健康检查。

首先，安装对应的健康检查扩展包：

dotnet add package Microsoft.Extensions.Diagnostics.HealthChecks.EntityFrameworkCore

然后，在 Program.cs 中配置 DbContext 并注册数据库健康检查：

using Microsoft.EntityFrameworkCore;var builder = WebApplication.CreateBuilder(args);// 添加数据库上下文builder.Services.AddDbContext<MyDbContext>(options =>    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));// 添加健康检查，并包含数据库检查builder.Services.AddHealthChecks()    .AddDbContextCheck<MyDbContext>();var app = builder.Build();app.MapHealthChecks("/health");app.Run();

注意：你需要先定义 MyDbContext 类，并在 appsettings.json 中配置连接字符串。

第四步：美化健康检查响应（可选）

默认情况下，健康检查返回的是纯文本。你可以配置它返回结构化的 JSON，便于程序解析：

using Microsoft.AspNetCore.Diagnostics.HealthChecks;app.MapHealthChecks("/health", new HealthCheckOptions{    ResponseWriter = async (context, report) =>    {        var result = new        {            status = report.Status.ToString(),            checks = report.Entries.Select(e => new            {                e.Key,                status = e.Value.Status.ToString(),                description = e.Value.Description            })        };        context.Response.ContentType = "application/json";        await context.Response.WriteAsJsonAsync(result);    }});

现在访问 /health 将返回类似以下的 JSON：

{  "status": "Healthy",  "checks": [    {      "key": "MyDbContext",      "status": "Healthy",      "description": null    }  ]}

总结

通过本教程，你已经掌握了如何在 ASP.NET Core 应用中启用和配置 健康检查（Health Checks）。这项功能不仅能提升系统的可观测性，还能与 Kubernetes、Docker Swarm 等平台无缝集成，实现自动故障恢复。

记住，合理的健康检查策略是构建高可用 .NET Core 应用的关键一环。无论是监控数据库连接，还是验证外部服务状态，ASP.NET Core 健康检查都能为你提供清晰、实时的反馈。

赶快在你的项目中试试吧！更多高级用法（如 UI 可视化面板、自定义检查逻辑）可参考官方文档。

关键词：ASP.NET Core健康检查, Health Checks, .NET Core监控, 应用健康状态