为何无法对pvermeyden/nodejs-hello-world容器执行健康检查？

问题根源 #

你的node容器健康检查失败有两个核心原因：

1. 端口错误：容器内部的Node应用监听的是80端口（从ports: "8080:80"映射关系可知，8080是宿主机端口），但健康检查命令里请求的是http://localhost:8080，这在容器内部是无效的。
2. 工具缺失：大部分轻量Node镜像默认不预装curl工具，直接用curl命令会导致执行失败。

修复方案 #

方案1：修正端口并使用wget（推荐，若镜像包含wget） #

修改docker-compose.yaml中app服务的健康检查配置：

healthcheck:
  test: ["CMD", "wget", "--spider", "-q", "http://localhost:80"]
  interval: 2s
  start_period: 1s
  timeout: 10s
  retries: 3

--spider参数让wget只检查资源是否存在，不下载内容，适合健康检查场景。

方案2：使用nc检查端口监听（无需HTTP请求） #

如果镜像包含netcat（nc），可以直接检查80端口是否处于监听状态：

healthcheck:
  test: ["CMD", "nc", "-z", "localhost", "80"]
  interval: 2s
  start_period: 1s
  timeout: 10s
  retries: 3

-z参数表示只扫描端口，不发送数据，返回0表示端口正常监听。

方案3：用Node脚本做健康检查（无额外工具依赖） #

利用容器本身的Node环境，创建一个简单的健康检查脚本healthcheck.js：

const http = require('http');

const request = http.get('http://localhost:80', (res) => {
  process.exit(res.statusCode === 200 ? 0 : 1);
});

request.on('error', () => process.exit(1));

然后修改docker-compose.yaml挂载脚本并配置健康检查：

app:
  image: pvermeyden/nodejs-hello-world:a1e8cf1edcc04e6d905078aed9861807f6da0da4
  container_name: node
  ports:
    - "8080:80" 
  volumes:
    - ./healthcheck.js:/app/healthcheck.js
  healthcheck:
    test: ["CMD", "node", "/app/healthcheck.js"]
    interval: 2s
    start_period: 1s
    timeout: 10s
    retries: 3

验证方法 #

修改配置后重启服务：

docker-compose down && docker-compose up -d

等待几秒后查看容器状态：

docker ps

node容器的状态应该会从unhealthy变为healthy。

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