Docker Compose未调用容器健康检查测试端点问题求助

核心问题分析 #

容器启动正常、宿主机能访问健康端点，但Compose未执行健康检查，大概率是健康检查命令本身在容器内无法正常执行，或者目标地址错误。

具体排查与修复步骤 #

1. 修正健康检查的目标端口 #

容器内部的服务监听的是8080端口（从ports: "8081:8080"可知，8081是宿主机端口，容器内服务用的是8080）。你之前的健康检查用了localhost:8081，这在容器内部是无效的——容器内没有把8081映射到自己的服务，请求根本无法到达目标端点。

正确的健康检查命令应该指向容器内的8080端口：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8080/system/healthcheck"]
  interval: 30s
  retries: 5
  timeout: 10s

2. 确认容器内是否安装了curl #

很多轻量级基础镜像（比如Alpine、OpenJDK精简版）默认不包含curl命令。如果容器里没有curl，健康检查命令会直接执行失败，但可能因为没有明确的错误输出，导致Compose没有表现出重启或报错的行为。

解决办法：

• 在你的Dockerfile中添加安装curl的步骤：
  • Debian/Ubuntu系镜像：

    RUN apt-get update && apt-get install -y --no-install-recommends curl \
        && rm -rf /var/lib/apt/lists/*
    

  • Alpine镜像：

    RUN apk add --no-cache curl
    

• 或换用容器内已有的工具（比如wget，如果镜像自带）：

  healthcheck:
    test: ["CMD", "wget", "--spider", "-q", "http://localhost:8080/system/healthcheck"]
    interval: 30s
    retries: 5
    timeout: 10s
  

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

3. 查看健康检查的执行日志 #

要确认健康检查的具体执行情况，可通过以下命令查看容器的健康检查状态和日志：

# 查看容器健康检查详情（格式化输出）
docker inspect --format='{{json .State.Health}}' <容器名或ID> | python3 -m json.tool

# 查看容器日志（包含健康检查的输出）
docker-compose logs middleware

日志会直接显示执行错误，比如command not found表示curl不存在，Connection refused表示地址/端口错误等。

4. 检查健康检查的配置格式 #

确保test参数格式正确：

• 字符串格式：需用双引号包裹，比如test: "curl -f http://localhost:8080/system/healthcheck || exit 1"
• 数组格式（推荐，避免shell转义问题）：test: ["CMD", "curl", "-f", "http://localhost:8080/system/healthcheck"]

验证修复 #

修改配置后，重启容器：

docker-compose up -d --force-recreate middleware

等待30秒（你的interval时间），用docker ps查看容器状态，正常情况下会显示healthy。

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