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应用连接数据库排查。