MinIO容器显示不健康但curl请求健康接口返回200状态码

1. 排查健康检查配置的端口/路径问题 #

容器的健康检查是在容器内部执行的，和宿主机的端口映射无关。如果你的宿主机用9001访问控制台，但MinIO的健康接口默认绑定在数据端口9000上，容器内部的健康检查请求若写错端口就会失败。

• 检查Docker Compose中的healthcheck配置，比如错误示例：

  healthcheck:
    test: ["CMD", "curl", "-f", "http://127.0.0.1:9001/minio/health/live"]
    interval: 30s
    timeout: 10s
    retries: 3
  

• 修正为容器内部的健康端口（通常为9000）：

  healthcheck:
    test: ["CMD", "curl", "-f", "http://127.0.0.1:9000/minio/health/live"]
    interval: 30s
    timeout: 10s
    retries: 3
  

2. 修复COMMAND字段异常问题 #

MinIO容器的COMMAND异常通常是启动命令配置错误导致的，先通过docker ps查看当前COMMAND，对比官方标准启动命令：

• 标准MinIO启动命令（带控制台端口指定）：

  minio server /data --console-address ":9001"
  

• 在Docker Compose中确保command配置正确：

  services:
    findra-minio:
      image: minio/minio:latest
      command: server /data --console-address ":9001"
      ports:
        - "9000:9000"  # 数据端口
        - "9001:9001"  # 控制台端口
      volumes:
        - minio-data:/data
      # 其他配置...
  

• 进入容器验证进程状态：

  docker exec -it findra-minio ps aux
  

  确认MinIO进程参数是否符合预期，若进程异常，说明启动命令有误，需修正。

3. 检查容器内部的健康检查工具可用性 #

部分MinIO镜像默认未安装curl，导致健康检查的curl命令执行失败（虽然宿主机能访问，但容器内部无法执行该命令）。

• 替换为MinIO自带的mc命令做健康检查：

  healthcheck:
    test: ["CMD", "mc", "ready", "local"]
    interval: 30s
    timeout: 10s
    retries: 3
  

• 手动验证容器内部的健康接口访问：

  docker exec -it findra-minio curl -I http://127.0.0.1:9000/minio/health/live
  

  若返回200则说明接口正常，问题出在健康检查配置；若返回失败，需排查容器内部网络或MinIO启动状态。

4. 重启或重新部署容器 #

修改配置后，重启容器使配置生效：

docker-compose restart findra-minio

若重启无效，强制重新创建容器：

docker-compose up -d --force-recreate findra-minio

内容的提问来源于stack exchange，提问作者Juan Pablo B