用途:为 Next.js 与 FastAPI 服务建立三层健康探针体系,并为 Docker、cron 与路由验证提供统一模式。
主要能力:一是三层探针分离——存活(/health、/api/health)仅确认进程存活、就绪(/ready)检查数据库与缓存等关键依赖、深度检查(/api/health/deep)并行探测全部依赖并测量延迟;二是状态模型,healthy/degraded 返回 200,unhealthy 返回 503,任一依赖 unhealthy 则整体 unhealthy;三是依赖检查并行执行(Promise.all 或 asyncio.gather),每项设 5 秒超时;四是 Docker healthcheck 示例,PostgreSQL 用 pg_isready -U starter_user -d starter_db,Redis 用 redis-cli ping,应用容器用 curl 探测存活端点,并配置 interval、timeout、retries、start_period 与 service_healthy 依赖顺序;五是 /api/cron/health-check 每 5 分钟执行,需 CRON_SECRET bearer 令牌;六是 /api/health/routes 扫描 app/api/ 下的 route.ts 发现路由,可选 ?verify=true 发送 GET 验证;七是 scripts/health-check.ps1 六阶段综合检查,退出码 0 健康、1 不健康。
使用方式:新增端点时确保三层分离、状态值与状态码正确、包含 timestamp 与 version;新增依赖时按模板添加 checker 并加入深度端点并行数组;Docker healthcheck 使用服务原生命令;cron 端点需校验 CRON_SECRET。
适用场景:新增健康端点、集成新依赖、配置容器健康检查、设置周期监控、实现启动/存活/就绪探针。
限制:资料未提供 npm 包名或安装命令;深度检查过慢不适合负载均衡探针;健康响应不应暴露内部错误或堆栈;服务 URL 应使用环境变量而非硬编码。