Codex 報錯 503 怎麼辦：Model temporarily overloaded 的官方說法，Retry-After 與重試辦法

本文根據 OpenAI API 錯誤碼文檔、Codex 排查頁和配置文檔整理，資料核對於 2026-10-30。官方沒有專門解釋 Codex 裏的 503，下面寫的是 API 文檔對 503 的說法和通用重試方法。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

• 在 Codex 裏看到 503、Service Unavailable 或 server_is_overloaded 的人；
• 任務跑到一半突然報錯、想知道要不要重新開始的人；
• 在 config.toml 裏用了第三方提供方的人。

結論先說

1. 官方 API 文檔裏，503 對應「Model temporarily overloaded」，類型 service_unavailable_error，代碼 server_is_overloaded，意思是模型暫時過載，不是你的帳號或額度出了問題。
2. 官方的處理辦法：響應裏有 Retry-After，就至少等它寫的時間再重試；沒有就逐步拉長重試間隔；持續出現就看狀態頁。
3. 不要連續狂點重發，也不要因此退訂、重裝。
4. 持續不好又沒有狀態頁事件，提交反饋（輸入框輸入 /），帶上 request id 和 session ID。

圖：本站根據 OpenAI API 錯誤碼文檔 整理的示意圖

官方對 503 的原話怎麼理解

API 錯誤碼頁對 503 的描述是：原因是模型暫時過載；解決辦法是——如果響應裏有 Retry-After 頭，至少等它指定的時間再重試；如果沒有，就增加重試之間的間隔；錯誤持續時檢查狀態頁。

通俗地說：這是服務端忙不過來，不是請求寫錯了。你的提示詞、項目文件、登入狀態通常都不用改。對比：401 是認證問題，見 /guides/codex-401-unauthorized-error；429 是請求或額度的限制，見 /guides/codex-exceeded-retry-limit-429-too-many-requests。

一、怎麼重試才對

圖：本站根據 OpenAI API 錯誤碼文檔 整理的示意圖

• 先停一下。 報錯的那一秒再發，大概率還是同樣的結果；
• 有等待時間就照做。 Retry-After 是服務端明確告訴你的下限；
• 沒有就逐步拉長。 官方在 429 的建議裏寫過：沒有 Retry-After 時，用「指數退避加隨機抖動」，並限制重試次數；503 的做法與之一致；
• 不急的任務晚點再跑，也可以換個模型，不同模型的繁忙程度不一定一樣，換模型見 /guides/codex-switch-model-reasoning-effort。

Codex 自己也會重試：配置參考裏，HTTP 請求預設重試 4 次、流式中斷預設重試 5 次，所以你看到 503 往往是它試過之後的結果。

二、看狀態頁

503 持續超過幾分鐘，就打開 status.openai.com，看 Codex、ChatGPT 相關組件有沒有事件。讀法見 /guides/chatgpt-down-check-status-page。有事件就等官方恢復。

三、用了第三方提供方時

官方配置文檔允許用 [model_providers.<id>] 配其他地址，還可以給每個提供方單獨設定 request_max_retries、stream_max_retries、stream_idle_timeout_ms（預設依次是 4、5、300000 毫秒）。此時 503 可能是那個提供方產生的，OpenAI 的狀態頁幫不上忙，要看對方的狀態與說明。想確認是不是 Codex 的問題，可以暫時回到官方登入再試，配置方式見 /guides/codex-third-party-models-deepseek-gemini-grok。

四、任務中斷了怎麼辦

官方排查頁對「卡住的對話」的建議：看 Codex 是否在等你批准某個操作；在終端裏跑一條簡單命令如 git status；新開一個對話、提示詞縮小一些再試。503 之後接着做，可以在新對話裏先讓它讀一下當前改動，再繼續。

常見問題

Q：503 會扣額度嗎？

官方文檔沒有說明，也沒有說失敗的請求是否計費，以用量頁面顯示為準，見 /guides/codex-usage-limits。

Q：高峰期更容易出現嗎？

官方沒有給出規律，只說是「暫時過載」。

Q：升級套餐能避免 503 嗎？

官方文檔沒有這樣寫。額度類問題可以參考 /chongzhi/chatgpt-plus 的說明，但 503 本身不是額度錯誤。

參考資料

• OpenAI API 錯誤碼 — https://developers.openai.com/api/docs/guides/error-codes
• Codex 官方排查頁 — https://learn.chatgpt.com/docs/reference/troubleshooting
• Codex 配置文檔（自定義提供方）— https://learn.chatgpt.com/docs/config-file/config-advanced
• OpenAI 狀態頁 — https://status.openai.com/