Docker显示unhealthy,服务为什么还在运行
网站还能打开,docker ps却显示Up ... (unhealthy),这两件事可以同时发生。容器主进程是否存在,与健康检查是否通过,是两套状态。页面能访问一次,也不能证明探针检测的数据库、后台接口或其他功能已经正常。
以下针对Linux上的Docker Engine和普通Compose部署。命令在平时管理该应用的终端执行,沿用原来的Docker连接方式;myapp替换成实际容器名。
看探针的错误,不只看应用日志
docker inspect --format '{{json .State.Health}}' myapp
docker inspect --format '{{json .Config.Healthcheck}}' myapp
docker logs --since 10m --tail 80 myapp
第一条看最近检查记录里的ExitCode、Output和起止时间;第二条确认真正生效的Test及检查配置。应用日志正常,探针仍可能因命令不存在或路径写错而失败。若没有健康检查对象,应先确认是否定义了检查,不能把“没检查”当成“检查通过”。
| 探针输出 | 优先核对 |
|---|---|
| command not found | 镜像里是否存在探针调用的程序 |
| Connection refused | 应用是否在容器内部的目标地址和端口监听 |
| 404或401 | 检查路径、认证方式是否仍然有效 |
| 超时 | 请求卡在应用本身,还是它依赖的数据库、DNS等环节 |
这些是排查方向,最终以同一时刻的具体错误为准。探针输出可能包含内部地址或认证信息,提交工单前先脱敏,不要把完整环境变量一并公开。
检查命令是在容器里面运行的
健康检查访问127.0.0.1,指的是当前容器。假如端口映射为宿主机8080到容器80,检查容器里的服务通常应使用内部80端口;不能因为电脑浏览器访问8080成功,就认定同一地址适用于探针。
只有原检查确实使用curl、镜像里已安装curl,而且目标是无副作用的健康接口时,才按实际配置复现。下面的8080和/health只是示例,必须换成原探针的内部端口及路径:
docker exec myapp curl --fail --silent --show-error --max-time 3 http://127.0.0.1:8080/health
保留与探针一致的用户、环境和工作目录,不要加--user root让测试“过关”。缺少工具应修订镜像构建或选用应用自带检查程序,不能把运行中的容器临时装好工具当成持久修复。
还要分清CMD和CMD-SHELL:前者直接执行参数列表,不负责展开管道、重定向;后者交给容器里的shell,精简镜像可能连shell都没有。复制检查命令时,应连同这种执行方式一起核对。
启动慢与持续故障,处理不同
只在初始化阶段失败,可根据实测启动耗时设置合理的start_period。宽限期内尚未成功的探针失败不计入连续失败次数;如果期间已经成功,后续失败就会开始计数。运行数小时后才出错,不能靠增加启动宽限解决。
普通Docker Engine的重启策略由容器退出等条件触发,单独变成unhealthy不会自动重启主进程。若现场还部署了编排器或外部守护工具,要查它们自己的处理策略。不要把检查改成固定返回成功,也不要无限放大超时来隐藏故障。容器实际退出或反复重启时,转看容器退出与重启排查。
修正配置后,确认新检查真正生效
Compose中的检查配置改变后,单纯restart不会重新创建容器。先备份原部署文件,确认持久化数据和回退方式。仅修改该服务检查配置、本地原镜像仍可用、依赖已运行且没有其他待发布改动时,可在允许短暂中断的窗口执行:
docker compose config --quiet &&
docker compose up -d --no-deps --no-build --pull never app
在原项目目录运行,app替换成Compose服务名,它未必等于容器名;原部署使用了-f、-p或--env-file时,两条命令都要沿用。配置检查失败就不会进入重建步骤。需要改镜像的情况,应按正常应用发布流程准备新镜像。
重新inspect实际容器,确认检查命令已变更,并观察超过原失败时长、覆盖多个检查周期的结果。最后完成一次真实的只读业务验证。Compose的service_healthy可以约束依赖启动时机,但应用运行中仍要自行处理依赖中断;容器间连接问题可继续看Docker应用连接数据库排查。