容灾与故障转移

网关只对安全场景自动重试:连接未建立、上游明确返回 5xx、或响应前超时。已经产生副作用的请求不会无条件重放。流式响应开始后也不会切换渠道,以免拼接出不完整内容。

客户端处理

读取 Retry-After,使用指数退避并设置最大次数;对视频等异步创建接口,请用幂等键避免重复任务。每次失败都记录 X-Gateway-Trace-ID,便于区分网关重试和供应商重试。

熔断恢复

连续失败会主动熔断渠道,经过冷却窗口后以少量探测流量半开。凭证、配额或协议错误不会因等待自动修复,应先修正渠道配置。