用 docker-compose.yml 内置 healthcheck 就够了，无需 Composer 脚本生成探针；因其易出错、耦合强、与运行时脱节，而正确配置需显式设置 test、interval、timeout、retries 和 start_period，并注意 Docker Compose v2 和基础镜像兼容性。
直接说结论：用 docker-compose.yml 内置的 healthcheck 就够了，不需要额外写 Composer 脚本生成探针 —— 那只会把简单事情搞复杂，还容易和实际运行时行为脱节。
为什么不用 Composer 脚本生成健康检查？
Composer 是 PHP 依赖管理工具，不是容器编排生成器。所谓“一键生成微服务基础探针”，本质是把 curl 或 netcat 命令硬编码进 YAML，再套个 PHP 脚本包装——这既没提升可维护性，又引入了额外构建步骤和语言耦合。
常见错误现象：composer run health:generate 输出的 YAML 字段缩进错乱、端口写死、HTTP 超时未设、健康接口路径和实际服务不一致。
- 微服务启动后监听的是
/healthz，脚本却生成了/actuator/health - 脚本默认用
curl -f http://localhost:8080/health，但容器内localhost指向自身，不是目标服务 - 生成的
interval设为10s，但服务冷启动要 25 秒，结果容器反复重启
怎么正确配置 docker-compose.yml 的 healthcheck？
所有主流语言的 Web 框架（Spring Boot、Express、FastAPI、Laravel）都支持暴露标准健康端点，healthcheck 直接调它就行，无需中间层。
关键参数必须显式声明，不能依赖默认值：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
test：推荐用["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3000/health"]（比curl更轻量，且--spider不下载响应体） -
interval：至少大于服务首次响应时间，Java 应用建议设30s -
timeout：别超5s，否则拖慢整体健康评估 -
retries：设3，避免瞬时网络抖动误判 -
start_period：必须设！例如60s，给慢启动服务留出缓冲期
示例片段：
services:
api:
image: my-api:latest
healthcheck:
test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:8000/health"]
interval: 30s
timeout: 5s
retries: 3
start_period: 60s
什么时候真需要外部探针脚本？
仅当健康逻辑无法通过 HTTP 端点表达时才考虑，比如：
- 检查本地磁盘剩余空间是否低于 10%
- 验证与下游 PostgreSQL 连接是否可用（且不能只连通，还要能执行
SELECT 1） - 确认 Redis 中某个 key 是否存在并有预期 TTL
这种场景下，脚本应放在镜像内部（如 /health.sh），由 healthcheck.test 直接调用，而不是在 compose 构建阶段用 Composer 生成。否则 CI 流水线里改个健康策略就得重跑 PHP 环境。
最容易被忽略的兼容性细节
healthcheck 在 Docker Desktop（Mac/Windows）和 Linux 生产环境表现一致，但有两个坑：
- Docker Compose v1（
docker-compose命令）不支持start_period，必须升级到 v2（docker compose） - Alpine 镜像默认没装
wget或curl，test命令会直接报sh: wget: not found，得在Dockerfile里补：RUN apk add --no-cache wget
别为了“自动化生成”绕开这些真实约束——容器健康检查的核心是稳定可靠，不是代码行数少。
