用途:为不同端点类型设置可配置的超时,避免任一请求无限期阻塞资源,并与 KYC 流水线的 8 秒 SLO 对齐。适用于 api_gateway_agent 场景,验证类总超时需小于 8 秒,查询类端点小于 2 秒。
主要能力与用法:在 Nginx 中按 location 配置超时,例如 /v1/verify 使用 proxy_read_timeout 8s、proxy_connect_timeout 2s、proxy_send_timeout 2s,/v1/status 的 proxy_read_timeout 为 2s;keepalive 全局超时设为 keepalive_timeout 65s。在 FastAPI 中用 asyncio 超时实现干净取消,例如 async with asyncio.timeout(7.5) 预留 0.5s 响应余量,再调用 orchestrator.verify(session)。若超时则返回 504 Gateway Timeout 并带上 session_id 以便重试。超时需记录到指标 gateway_timeouts_total{endpoint},并在 5 分钟窗口内超时率超过 1% 时告警。
限制与注意事项:网关超时应大于后端超时,避免截断有效响应;客户端 SDK 也应实现客户端侧超时;超时应可按环境配置,开发环境更宽松、生产环境更严格。其他细节暂未提供。