容器启动成功为什么不等于服务可用：从进程、端口到HTTP验证

执行容器启动命令后，看到一串容器编号，或者在列表中看到“Up”，很容易认为部署已经完成。实际上，启动、监听、连通和业务正确是几件不同的事。一个进程可以持续运行，却因为初始化未完成、依赖不可用或请求处理卡住而无法提供服务。验证应沿着真实请求的路径逐层推进。

下面以名为 web-demo 的 HTTP 容器说明检查方法。命令用于展示思路，端口和访问路径应按实际应用调整，下文侧重验证方法。

先确认进程状态与退出线索

Docker 官方文档说明，docker ps 默认只显示运行中的容器，加上 -a 才能查看已停止的容器。[1]

docker ps -a --filter "name=web-demo"
docker container inspect web-demo
docker logs --tail 100 --timestamps web-demo

查看状态时，应区分稳定运行、反复重启和已经退出。检查容器详情中的启动时间、退出码和错误信息，再把日志时间与请求失败时间对应起来。日志中的“启动完成”只代表程序记录过这条消息；后续仍可能发生异常。docker logs 依赖应用日志输出和日志驱动配置，日志为空也不能证明服务正常。[2]

再确认端口与访问方向

端口发布和进程监听属于不同层次。镜像中的 EXPOSE 主要描述应用预期使用的端口，不会自动完成宿主机端口发布。创建容器时，参数 -p 8080:80 表示将宿主机的 8080 端口映射到容器的 80 端口，可用下面的命令检查发布配置。[3]

docker port web-demo

映射存在，仍需确认应用确实监听了容器内的目标端口。若应用只绑定容器的回环接口，来自容器外的转发请求可能无法到达。若容器内部访问成功、宿主机访问失败，应优先检查映射、监听范围和网络路径；若宿主机成功、调用方失败，则继续检查入口代理、网络策略以及域名解析。

HTTP验证要检查内容

建立连接只说明某个程序接受了连接。真正的服务验证还需要检查 HTTP 状态码、响应内容和必要的业务字段。例如，在 Docker 宿主机上访问已发布的端口：

curl -i --max-time 5 http://localhost:8080/

这条命令会显示响应头并限制总耗时，但默认不会把所有 HTTP 错误响应变成命令失败。用于脚本时，可增加 --fail，让常见的 HTTP 4xx、5xx 返回非零退出码，再另外验证响应内容。[5] 连接超时、HTTP 拒绝和业务错误应分别记录，才能决定下一步检查什么。

响应应来自预期应用，并符合该接口约定。看到默认欢迎页，可能只证明前置 Web 服务正常；返回 200，也可能是统一错误页面。对于业务接口，可以检查固定字段、数据类型和返回值，而不只判断页面能否打开。

localhost 指执行 curl 的主机。如果 Docker 运行在远端，不能把本机访问失败直接认定为远端容器故障。宿主机验证成功后，还应从真实调用方验证一次完整路径，这样才能覆盖代理、证书与网络入口等环节。

还要观察时间维度。一次成功只代表那个时刻的结果，不能证明之后持续可用。应用启动时可能需要加载配置、建立连接或预热缓存，可在有限时间内重复验证，并保存每次结果。重试应有间隔和总时限，避免无限等待掩盖故障；涉及写入的业务验证则应使用隔离测试数据，不能把重复下单之类操作当成普通探针。

把重复检查变成健康探针

Docker 支持使用 HEALTHCHECK 周期执行容器内命令，并维护 starting、healthy、unhealthy 等健康状态。[4] 例如，应用已提供 /health 接口，且镜像内已安装 curl 时，可以在 Dockerfile 中配置：

HEALTHCHECK --interval=30s --timeout=3s --start-period=20s --retries=3 \
  CMD curl -f http://localhost/health || exit 1

探针应有明确超时，并给初始化留出合理时间。接口应反映选定的健康标准，不能永远返回成功；也不宜把所有外围依赖都无差别绑定到同一个判断。容器内探针通过，仍不能证明外部访问链路正常，恢复策略也需要单独设计。

交付验证时，可分别记录进程状态、端口发布、HTTP响应以及业务结果。这样，出现故障时就能明确停在哪一层，也能把“容器正在运行”推进为有证据支持的“服务满足当前使用要求”。

说明：本文参考官方文档，使用AI辅助整理；命令为教学示例，实际执行情况需另行记录。

官方参考：
[1] Docker：docker container ls、inspect
[2] Docker：docker container logs
[3] Docker：Publishing and exposing ports、docker container port
[4] Dockerfile：HEALTHCHECK
[5] curl：命令行参数说明