跳到主要内容

运维探针（无鉴权）

GET /health​

进程存活探针。进程能响应即返回 200：

{ "status": "ok", "jimeng_configured": true, "bocha_configured": true }

GET /readyz​

就绪探针，检查两件事，任一不满足返回 503：

  1. 数据库 schema 版本与代码要求的 Alembic 版本严格一致（新代码遇旧库、旧代码遇新库都会拒绝服务——所以部署顺序永远是先迁移后发版）；
  2. AI_GATEWAY_READY_PRODUCTS（默认 text,image,search）中的每个产品都有活跃模型、活跃线路，且线路引用的凭证环境变量齐备。

planned 状态的规划中能力不参与就绪检查。

503 响应会列出未就绪的产品与原因（no_active_models / no_active_deployments / missing_env），可直接用于告警定位：

{
  "status": "not_ready",
  "requiredProducts": ["text", "image", "search"],
  "notReadyProducts": [
    { "type": "image", "reason": "missing_env", "missingEnv": ["VOLCENGINE_ACCESS_KEY_ID"] }
  ]
}