CodexManager额度耗尽如何自动切号429故障转移与透明切换机制原理详解【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager使用 CodexManager 时某个账号额度耗尽或被限流HTTP 429并不等于任务失败。CodexManager 的本地网关内置了429 故障转移与透明切号机制当上游返回 429 或明确的额度耗尽错误时网关会在同一个客户端请求内自动尝试下一个候选账号客户端几乎无感知。本文面向新手讲清楚这套自动切号机制的触发条件、冷却退避、流式预检与排障方法。一、429 故障转移哪些错误会触发切号并不是所有上游错误都会触发切号。网关的故障转移策略failover_policy.rs只对可操作的错误生效触发条件处理方式HTTP401 / 403 / 404 / 408 / 409 / 429标记该账号冷却切换下一个候选账号明确的额度耗尽文案如 Youve hit your usage limit、quota exceeded同上账号停用 / 账号失效类错误同上其他 5xx走独立冷却时长30 秒后切号核心逻辑很简单只有当「错误可判定为账号问题」且「候选池里还有下一个账号」时才会执行切号否则直接把上游响应原样返回给客户端见 fallback_branch.rs。二、冷却与阶梯退避防止连续误伤切号不是无脑重试。CodexManager 为每个账号维护了冷却状态cooldown.rs普通冷却网络错误约 20 秒、5xx 约 30 秒、4xx 约 20 秒429 阶梯退避短时间连续被限流时冷却时长按阶梯递增 ——45 秒 → 300 秒 → 1800 秒 → 7200 秒自动忘仇若两次 429 相隔超过 30 分钟视为新一轮限流计数清零避免一个账号被长期误伤。冷却中的账号会直接从候选池中跳过对应账号处于 cooldown的跳过原因直到冷却结束才重新参与路由。三、/v1/responses 流式预检10 秒窗口内的透明切号Codex 的流式请求有个难点上游可能先返回HTTP 200然后在 SSE 正文里才吐出额度错误。CodexManager 的流式预检stream_preflight.rs解决了这个问题网关先缓冲上游 SSE 前 64KB而不是立即转发在缓冲中识别额度错误前缀usage limit、quota exceeded 等与error/response.failed事件只要真实文本、工具调用等语义事件尚未交付给客户端就在 10 秒预检窗口内透明切换到下一个账号窗口到期后提交已缓冲的原流避免正常慢首字导致下游响应头长时间无返回。这就是透明切换的含义你看到的仍是一次请求、一个结果背后已经换了账号。四、安全边界为什么有时不切透明切号有明确红线见 FAQ与账号命中规则.md✅输出前额度错误出现在真实文本/工具调用之前 → 允许切换❌输出后一旦任何语义事件已交付给客户端网关绝不把请求重放到另一账号 —— 以免重复输出、重复计费或重复执行工具的副作用❌超窗超过 10 秒预检窗口才到达的额度错误不再透明切号直接提交原流。对于 Responses WebSocket 链路跨账号重试时会移除旧账号的 response/session 亲和性并在工具输出前补回已完成的function_call上下文保证切换后上下文不丢。五、账号命中顺序切号切到谁候选池顺序由账号的sort值、更新时间共同决定sort ASC, updated_at DESC, id ASC两种策略对应不同行为详见 gateway/README.mdordered顺序优先默认按账号优先级依次尝试0 → 1 → 2 → 3前序账号不可用或失败就自动顺延balanced均衡轮询按「平台密钥 模型」维度严格轮询让多个账号额度消耗更均匀。另外手动指定账号会旋转到队首并优先命中且不会被一次 429 自动清掉单账号并发上限默认为 1满载账号会被候选预检跳过避免长连接把同一账号压垮Codex-First 模式下自动切换账号会同步切换上游线程世代同一会话始终只绑定一个活动账号。六、如何验证切号过程3 条排障日志所有切号行为都有据可查。查看数据库同目录下的gateway-trace.log关注三类事件CANDIDATE_POOL本次请求的候选顺序含strategy与ordered_candidatesCANDIDATE_START/CANDIDATE_SKIP实际尝试了哪个账号、跳过了哪些账号及原因REQUEST_FINAL最终命中的账号。再配合仪表盘中的请求日志查看每次请求的耗时、上游状态码与命中账号相关实现位于 request_log.rs即可完整还原一次 429 自动切号的全过程。小结CodexManager 的额度耗尽自动切号由四块能力拼成429/额度错误识别 → 阶梯冷却退避 → 流式 10 秒预检透明切换 → 输出后不重放的安全边界。只要候选池里还有可用账号一次 429 就不会打断你的 Codex 会话。更多细节可阅读命中规则docs/zh-CN/report/FAQ与账号命中规则.md路由与切号实现crates/service/src/gateway/routing/流式预检crates/service/src/gateway/upstream/proxy_pipeline/stream_preflight.rs【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考