ASP.NET应用Docker化后HealthChecks健康检查失败问题

问题根源分析 #

服务能正常运行但健康检查显示unhealthy，主要有几个常见原因：

• 健康检查使用HTTPS，但dotnet run启动的开发服务器默认仅开启HTTP端口，请求直接失败
• 容器内部访问用了服务名asp-service，但健康检查是在容器内部执行的，应使用localhost或127.0.0.1
• bitnami/dotnet-sdk镜像可能未预装curl，导致健康检查命令执行失败
• ASP.NET应用未明确配置监听0.0.0.0:8080，仅绑定容器内部127.0.0.1，导致健康检查无法访问

具体修复步骤 #

1. 修改Docker Compose健康检查配置 #

将健康检查目标改为HTTP协议+localhost，根据镜像情况选择curl或wget：

若镜像已安装curl

healthcheck:
  test: curl --fail http://localhost:8080/health || exit 1
  interval: 30s
  timeout: 30s
  retries: 3

若镜像未安装curl（改用wget）

healthcheck:
  test: wget --spider --quiet http://localhost:8080/health || exit 1
  interval: 30s
  timeout: 30s
  retries: 3

2. 确保ASP.NET应用监听正确端口 #

两种配置方式二选一即可：

方式1：修改代码配置监听端口

在Program.cs中添加端口监听配置：

var builder = WebApplication.CreateBuilder(args);

// 配置应用监听所有接口的8080端口
builder.WebHost.UseUrls("http://0.0.0.0:8080");

builder.Services.AddHealthChecks();

var app = builder.Build();

app.MapGet("/", () => "Hello World!");
app.MapHealthChecks("/health");

app.Run();

方式2：通过Docker Compose环境变量配置

无需修改代码，在docker-compose中添加环境变量：

services:
asp-service:
  image: bitnami/dotnet-sdk
  working_dir: /app
  command: "./run.sh"
  volumes:
    - "./:/app:rw"
  ports:
    - 8080:8080
  environment:
    - ASPNETCORE_URLS=http://0.0.0.0:8080
  healthcheck:
    test: curl --fail http://localhost:8080/health || exit 1
    interval: 30s
    timeout: 30s
    retries: 3

3. 验证修复效果 #

重启服务后查看状态：

docker-compose down && docker-compose up -d
# 等待30秒后检查状态
docker ps

若仍有问题，可进入容器手动测试健康端点：

docker exec -it <容器ID> curl http://localhost:8080/health

确认是否返回Healthy和200状态码，进一步定位问题。

内容的提问来源于stack exchange，提问作者JDChris100