Docker 健康检查是如何工作的，为什么它们很重要？

Question

Accepted Answer

一个 **health check** 告诉 Docker（或编排工具）如何确定容器的应用程序是否 **实际在工作**，而不仅仅是在运行。容器的进程可能在运行，而应用程序却已损坏（挂起、无法连接到其数据库）— 健康检查可以检测到这一点，以便平台可以做出反应。

## 定义健康检查

```dockerfile
# in a Dockerfile
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1
# → Docker runs this command periodically; exit 0 = healthy, non-zero = unhealthy
```

```yaml
# in docker-compose.yml
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 3s
  retries: 3
  start_period: 10s    # grace period on startup before failures count
```

Docker 定期运行健康检查命令；容器的状态根据结果变为 `healthy` 或 `unhealthy`（在 `docker ps` 中可见）。

## 运行中 vs 健康（关键区别）

```text
RUNNING → the container's process is alive (but the APP might be hung/broken)
HEALTHY → the health check confirms the app actually WORKS (responds correctly)
→ A container can be RUNNING but NOT HEALTHY (e.g. the app deadlocked, lost its DB).
  Without a health check, the platform only knows "running" — and keeps sending traffic
  to a broken container.
```

## 为什么健康检查在操作上很重要

```text
✓ ORCHESTRATORS use them: restart unhealthy containers; route traffic only to healthy ones
✓ Compose depends_on: condition: service_healthy → wait for real readiness
✓ LIVENESS (is it alive? restart if not) vs READINESS (ready for traffic? hold traffic if not)
  → Kubernetes uses liveness + readiness probes (the same concept, more granular)
✓ Prevents serving requests from broken-but-running containers
```

## 为什么这很重要

理解 Docker 健康检查对于 **运行可靠的容器化应用程序** 很重要，所以它是有价值的操作知识。

关键的认识是 **运行中和健康** 之间的区别：容器的进程可能 **活跃但应用程序实际上已损坏**（挂起、死锁、无法连接到其数据库）— 如果没有健康检查，平台只知道容器在 "运行"，将 **继续将流量路由到损坏的容器**，导致故障。

健康检查通过定义如何验证应用程序 **实际在工作**（例如访问 `/health` 端点）来解决这个问题，所以容器的状态反映真实的健康状态，而不仅仅是进程活跃度。

这在 **操作上** 很重要，因为编排工具和工具会根据它采取行动：它们 **重启不健康的容器**（从挂起/死锁自动恢复），**仅将流量路由到健康的容器**（避免向损坏的实例发送请求），Compose 的 `depends_on: condition: service_healthy` 使用健康检查来等待真正的就绪状态（解决启动时的竞争条件）。

理解相关的 **liveness vs readiness** 区别（是否活跃且应该重启，vs 是否准备好接收流量）很重要，因为 **Kubernetes 使用基于这个相同概念的 liveness 和 readiness 探针** — 所以理解 Docker 健康检查直接转移到编排环境。

由于可靠运行需要区分 "运行中" 和 "实际在工作"，并对损坏但仍在运行的容器做出反应（重启它们，拒绝流量），而且由于健康检查是启用此功能的机制 — 被编排工具用于自我修复和流量路由 — 理解 Docker 健康检查是可靠运行容器的宝贵的、具有实际意义的知识，是生产稳定性的关键实践，可以防止损坏的容器默默继续接收流量的常见问题，以及编排工具维护应用程序健康的基础概念。