ASP.NET Core中间件健康检查集成（手把手教你为Web应用添加健康监控）

为什么需要健康检查？

• 快速发现服务异常
• 支持容器编排平台（如 Docker、Kubernetes）自动重启故障实例
• 提升系统可观测性（Observability）
• 便于 DevOps 自动化运维

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

打开终端，执行以下命令创建一个新的 Web API 项目：

dotnet new webapi -n MyHealthCheckAppcd MyHealthCheckApp

第二步：注册健康检查服务

打开 Program.cs 文件（.NET 6+ 使用顶层语句），添加健康检查服务：

using Microsoft.Extensions.Diagnostics.HealthChecks;var builder = WebApplication.CreateBuilder(args);// 添加健康检查服务builder.Services.AddHealthChecks();var app = builder.Build();// 配置健康检查中间件app.MapHealthChecks("/health");app.Run();

此时，你的应用已经具备最基本的健康检查能力。启动项目后，访问 http://localhost:5000/health 将返回 Healthy 状态。

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

真实场景中，我们通常需要检查数据库是否连通。下面以 SQL Server 为例：

// 在 Program.cs 中添加builder.Services.AddDbContext<MyDbContext>(options =>    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));builder.Services.AddHealthChecks()    .AddSqlServer(        connectionString: builder.Configuration.GetConnectionString("DefaultConnection"),        name: "SQL Server Check",        failureStatus: HealthStatus.Degraded,        tags: new[] { "db", "sqlserver" });

别忘了安装 NuGet 包：

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

第四步：启用 UI 可视化（可选但推荐）

为了更直观地查看健康状态，可以集成 Health Checks UI：

dotnet add package AspNetCore.HealthChecks.UIdotnet add package AspNetCore.HealthChecks.UI.Client

然后在 Program.cs 中配置：

builder.Services.AddHealthChecksUI(setupSettings: setup =>{    setup.AddHealthCheckEndpoint("Basic Health", "/health");}).AddInMemoryStorage();// 在 app 配置中app.MapHealthChecks("/health", new HealthCheckOptions{    ResponseWriter = UIResponseWriter.WriteHealthCheckUIResponse});app.MapHealthChecksUI();

现在访问 /healthchecks-ui 即可看到漂亮的仪表盘！

总结

通过本教程，你已经掌握了如何在 ASP.NET Core 应用中集成健康检查中间件，并能监控数据库等关键依赖。这项技术是构建高可用、可观测的现代 Web 应用的基础。无论你是初学者还是有经验的开发者，都建议在项目中启用健康检查功能。

记住，ASP.NET Core中间件 的灵活性让你可以轻松扩展健康检查逻辑，而 .NET Core健康检查集成 也已成为云原生应用的标准实践。掌握 Web应用监控 技能，将大大提升你的工程能力！

赶快动手试试吧！你的应用值得被“健康”守护。