答案是C#健康检查API通过Microsoft.Extensions.Diagnostics.HealthChecks实现,需定义IHealthCheck接口并注册服务。创建自定义健康检查类MyCustomHealthCheck实现CheckHealthAsync方法,根据服务状态返回Healthy或Unhealthy结果。在Program.cs中调用services.AddHealthChecks()添加检查项,支持自定义和内置检查(如SqlServer),并通过app.UseHealthChecks("/health")启用健康端点。健康状态分三种:Healthy(200)、Unhealthy(503)、Degraded(200可配置),用于监控应用状态并决定告警或重启策略。组合多个检查可构建生产级健康监测体系。

在 C# 中,健康检查 API 是通过 Microsoft.Extensions.Diagnostics.HealthChecks 命名空间提供的。它允许开发者定义应用的健康状态,并通过一个标准接口对外暴露。核心是实现 IHealthCheck 接口,并在依赖注入容器中注册健康检查服务。
定义健康检查的基本方式
要自定义一个健康检查,需要创建一个类实现 IHealthCheck 接口,重写 CheckHealthAsync 方法:
public class MyCustomHealthCheck : IHealthCheck
{
public async Task CheckHealthAsync(
HealthCheckContext context,
CancellationToken cancellationToken = default)
{
// 模拟检查逻辑
var isHealthy = await SomeService.IsAvailable(cancellationToken);
if (isHealthy)
{
return HealthCheckResult.Healthy("服务运行正常");
}
return HealthCheckResult.Unhealthy("服务不可用");
}}
在程序中注册和启用健康检查
在 Program.cs 或 Startup.cs 中添加健康检查服务并配置中间件:
- 调用
services.AddHealthChecks()注册健康检查服务 - 使用
.AddCheck添加自定义检查,或使用内置检查(如数据库、内存、网络等)() - 在请求管道中使用
app.UseHealthChecks("/health")启用端点
示例:
var builder = WebApplication.CreateBuilder(args);builder.Services.AddHealthChecks() .AddCheck
("custom_check") .AddSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")); var app = builder.Build();
app.UseHealthChecks("/health");
app.Run();
健康检查的返回状态说明
健康检查结果分为三种状态:
- Healthy:所有检查通过,HTTP 返回 200
- Unhealthy:关键服务异常,HTTP 返回 503
- Degraded:部分非关键服务有问题,但仍可工作,HTTP 返回 200(可配置)
这些状态帮助监控系统判断应用是否需要告警或重启。
基本上就这些。通过组合多个检查项,可以构建出适合生产环境的健康监测机制。










