Docker Desktop 本身不提供图形化配置健康检查的功能，HEALTHCHECK 必须通过 Dockerfile 定义、docker run 的 --health-* 参数覆盖，或 docker-compose.yml 中严格格式的 healthcheck 字段声明；所有配置均需符合大小写、语法及依赖约束（如 timeout

直接在 Docker Desktop 里无法单独“配置”健康检查——它只是 GUI 客户端，健康检查必须由镜像或运行时参数定义，Docker Desktop 本身不提供图形化开关或表单来添加/修改 HEALTHCHECK。

docker run 时用 --health-* 参数覆盖镜像默认检查

这是最常用、也最可控的方式，尤其适合本地调试和快速验证。Docker Desktop 底层调用的就是 docker run，所以你在 CLI 或 Compose 启动时加的参数，它完全支持。

• --health-cmd 必须是容器内可执行的命令，且返回码决定状态：0 → healthy，非 0 → unhealthy；推荐写成 curl -f --max-time 3 http://localhost:8080/health || exit 1，避免因超时 hang 住
• --health-interval 建议设为 15s～30s；太短（如 5s）可能压垮轻量服务，太长（如 2m）会让故障发现延迟
• --health-start-period 对 Spring Boot、Node.js 等冷启动慢的服务很关键；若应用通常需 45 秒初始化，这里至少设 60s，否则前几十秒反复失败会误标 unhealthy
• Docker Desktop 的 Dashboard 页面只显示健康状态（healthy/unhealthy），不展示参数详情；要确认是否生效，得用 CLI：docker inspect myapp --format='{{.HostConfig.HealthCheck}}'

docker-compose.yml 中 healthcheck 字段必须小写且格式严格

Docker Desktop 启动 Compose 项目时，会完整读取 healthcheck: 配置，但它对字段名和结构非常敏感——写错一个字母或大小写，整个 healthcheck 就静默失效。

Docker Compose Optimizer

优化 Docker Compose 配置，适用于开发和生产环境——审计服务、网络、卷、健康检查和资源管理。

下载

• test: 必须是数组格式，例如 ["CMD", "curl", "-f", "http://localhost:3000/ready"]；写成字符串 test: "curl -f ..." 会导致 Docker 忽略该配置，且不报错
• 所有字段名必须小写：interval、timeout、retries、start_period（注意不是 start-period 或 startPeriod）
• timeout 值必须小于 interval，否则 Docker 启动容器时会报错：invalid config for service xxx: 'timeout' must be smaller than 'interval'
• 如果镜像中已有 HEALTHCHECK，Compose 中的 healthcheck: 会完全替换它；如果镜像没定义，Compose 配置才真正起效

HEALTHCHECK 写在 Dockerfile 里才真正“固化”

Docker Desktop 本身不改写镜像，所以想让所有基于该镜像启动的容器（无论 CLI、Compose 还是第三方工具）都带统一健康逻辑，唯一可靠方式是把 HEALTHCHECK 写进 Dockerfile。

• 必须放在 CMD 或 ENTRYPOINT 之前或紧邻其后；若中间夹了 RUN 或 COPY，可能导致最终镜像层丢失该指令
• Alpine 类基础镜像默认不带 curl，得先 RUN apk add --no-cache curl，否则 curl -f 命令直接报 command not found，退出码 127 → 一直 unhealthy
• 禁用父镜像的健康检查，用 HEALTHCHECK NONE；别留空或注释掉，Docker 不识别注释里的 HEALTHCHECK
• 命令中慎用 localhost：某些网络模式下（如 host 或自定义 bridge）DNS 解析可能失败；更稳妥的是 127.0.0.1 或直接用应用绑定的 IP+端口

最容易被忽略的一点：健康检查命令本身是否真能反映业务就绪——比如只测端口通不通，但数据库连接池还没建好；或者用了 curl http://... 却没加 -f，导致 404 返回码仍是 0。这种“假健康”比不配还危险。