Docker容器Running状态仅表示PID 1进程存活，不等于Java应用真正可用；必须通过HEALTHCHECK指令结合Actuator健康端点等业务级检查，才能准确判断服务是否就绪。
Java 应用在 Docker 中运行时，光靠容器进程是否存活（PID 1 是否存在）不足以判断应用真正可用——比如 Spring Boot 启动卡在数据库连接、线程死锁或 Actuator 端点不可达，容器仍“活着”但已无法提供服务。Docker 的 HEALTHCHECK 指令正是为解决这个问题而设计：它定期执行命令，根据返回码判定容器健康状态，从而让编排工具（如 Docker Swarm、Kubernetes）能及时剔除不健康的实例。
在 Dockerfile 中配置 HEALTHCHECK（推荐方式）
最直接的方式是在构建镜像时通过 HEALTHCHECK 指令声明检查逻辑。对 Java 应用（尤其是 Spring Boot），通常利用其内置的 Actuator /actuator/health 端点：
- 确保应用已启用 Actuator 并暴露健康端点（
spring-boot-starter-actuator+management.endpoints.web.exposure.include=health） - 在 Dockerfile 中添加如下指令（放在 FROM 之后、CMD 之前）：
HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \ CMD curl -f http://localhost:8080/actuator/health || exit 1
说明：
–interval=30s：每 30 秒检查一次
–timeout=3s：命令超时为 3 秒
–start-period=30s：容器启动后前 30 秒内失败不计入重试
–retries=3：连续 3 次失败才标记为 unhealthycurl -f 表示 HTTP 非 2xx/3xx 状态码时返回非零退出码，Docker 会据此判定不健康
使用自定义健康检查脚本（更灵活、可复用）
当需要更复杂的判断逻辑（如检查数据库连接、JVM 内存水位、或多个端点组合）时，建议将健康检查封装成独立脚本（如 healthcheck.sh），再挂载或 COPY 到镜像中：
- 脚本内容示例（检查 Actuator 健康 + JVM 可响应）：
#!/bin/sh # 检查 Actuator 健康端点 if ! curl -sf http://localhost:8080/actuator/health | grep -q '"status":"UP"'; then exit 1 fi # 可选：检查 JVM 是否响应 JMX 或特定内部接口 exit 0
在 Dockerfile 中使用：
立即学习“Java免费学习笔记（深入）”；
COPY healthcheck.sh /healthcheck.sh RUN chmod +x /healthcheck.sh HEALTHCHECK CMD ["/healthcheck.sh"]
好处是逻辑清晰、易测试、便于 CI/CD 中统一维护，也避免因 curl 未安装导致检查失败（基础镜像如 eclipse-jetty 可能不含 curl）
运行时覆盖 HEALTHCHECK（适用于调试或临时调整）
如果不想修改镜像，也可在 docker run 时动态指定健康检查：
docker run -d \ --health-cmd "curl -f http://localhost:8080/actuator/health || exit 1" \ --health-interval=20s \ --health-timeout=5s \ --health-start-period=40s \ --health-retries=2 \ -p 8080:8080 my-java-app
注意：该方式只对当前容器生效，且需确保容器内已安装 curl（或改用 wget、busybox httpd 等轻量替代）；若镜像中已有 HEALTHCHECK，运行时参数会覆盖它
验证与排查健康状态
部署后可通过以下命令观察健康状态：
-
docker ps：查看 STATUS 列是否显示(healthy)或(unhealthy) -
docker inspect <container-id> | grep -A 10 Health：查看详细健康历史、上次检查结果、退出码等 - 若始终显示 unhealthy，常见原因包括：
– Actuator 端点路径或端口配置错误（确认 management.server.port 和 server.port 匹配）
– 应用未完全启动就触发首次检查（适当增大 --start-period）
– 容器内无 curl/wget（改用 sh -c 'echo > /dev/tcp/localhost/8080' 2>/dev/null 测试端口连通性，但无法验证业务逻辑）
– Spring Security 拦截了 /actuator/health（需配置 permitAll 或设置 management.endpoints.web.cors.allowed-origins）
