Codex 報錯 502 怎麼辦：官方沒單獨說明，狀態頁、網絡與自定義提供方的排查順序

本文根據 Codex 官方排查頁、OpenAI API 錯誤碼文檔和幫助中心的網絡建議整理，資料核對於 2026-10-30。官方沒有單獨解釋 502，所以本文寫的是官方對「服務端錯誤」的通用做法，不對 502 的原因下結論。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

• 在 Codex（桌面 App、命令行或 IDE 擴展）裏看到 502、Bad Gateway 的人；
• 同一條消息反覆 502、不知道該等還是該改設定的人；
• 自己在 config.toml 裏配了第三方地址的人。

結論先說

1. 先看狀態頁 status.openai.com。官方在網絡建議的第一步就是先排除系統性故障，有進行中的事件就只能等。
2. 偶發的先等一會兒再試。 官方 API 文檔對 500 的建議是「稍等後重試，持續出現再聯絡官方」；502 雖然沒寫，同屬服務端一側的錯誤，做法相近。
3. 只在某個網絡下出現，換手機熱點對比。 官方網絡建議最後一步就是區分「只有這台電腦」還是「整個網絡」。
4. 用了自定義提供方或網關，502 可能來自你填的那個地址，先查它。
5. 都不是就提交反饋：在 Codex 輸入框輸入 /，提交後會得到 session ID，官方要求把它給團隊。

圖：本站根據 OpenAI 幫助中心：網絡建議 與 API 錯誤碼 整理的示意圖

502 是什麼意思，官方說了什麼

官方沒有說。 OpenAI 的錯誤碼文檔列出了 400、401、403、429、500、503，沒有 502。Codex 的排查頁講的是卡住的對話、日誌位置、反饋方式，也沒有 502。

502 是 HTTP 的通用狀態碼，一般表示「中間的網關或代理從後面的伺服器拿到了不能用的回答」。這是網絡常識，不是 OpenAI 對 Codex 這條報錯的解釋。所以能確定的只有一點：請求在到達最終結果之前，在某一層出了問題，這一層是不是 OpenAI 的服務，單看這個數字判斷不了。

一、先排除官方故障

打開狀態頁，看 Codex、ChatGPT 相關組件有沒有正在處理的事件。怎麼讀狀態頁見 /guides/chatgpt-down-check-status-page。有事件就等，不要在這段時間裏反覆重發或反覆重裝，那樣既解決不了問題，也容易讓一輪任務白白消耗額度。

二、稍後重試，別連發

Codex 本身會自動重試：配置參考裏，HTTP 請求預設最多重試 4 次，流式連接中斷預設重試 5 次。你看到 502 報錯時，往往已經是它重試之後的結果。這時再手動連點，意義不大。官方的做法是等一會兒。同類的「連接中途斷開」見 /guides/codex-stream-disconnected-before-completion。

三、網絡與安全軟件

官方幫助中心的網絡建議是按順序排查：

1. 把 OpenAI / ChatGPT 的域名加入白名單，確認網頁過濾沒有返回奇怪的內容；
2. 允許 WebSocket 流量（443 端口，wss://chatgpt.com/ 等），否則 Codex 的流式輸出可能中途停住；
3. 檢查防火牆、網關、殺毒軟件，別攔截 ChatGPT（包括攔截 cookie）；
4. 區分是你這台機器的問題，還是整個網絡的問題，換成手機熱點對比。

圖：本站根據 Codex 官方排查頁 與幫助中心整理的示意圖

四、自定義提供方或網關

官方配置文檔允許在 config.toml 裏用 [model_providers.<id>] 配第三方地址。這種情況下，請求先到你填的 base_url，502 完全可能是那一方產生的。先用同一個地址在別的工具裏試，或者暫時去掉 model_provider、回到官方登入再試一次，就能分清。配置方法見 /guides/codex-third-party-models-deepseek-gemini-grok。

五、反饋時帶什麼

• 完整報錯原文、出現時間；
• codex --version 的版本號；
• 輸入 / 提交反饋後得到的 session ID；
• 日誌在 ~/.codex/sessions，貼出去之前先檢查有沒有路徑、密鑰等敏感資料。

不要貼令牌、密鑰。更多 Codex 報錯的對照見 /guides/codex-common-errors-summary。

常見問題

Q：502 和 503 有區別嗎？

官方只寫了 503（模型暫時過載，等待後重試），見 /guides/codex-503-service-unavailable-error；502 官方沒有說明。

Q：額度用完會報 502 嗎？

官方把額度用盡放在 429 一類，見 /guides/codex-exceeded-retry-limit-429-too-many-requests。需要更多額度可看 /chongzhi/chatgpt-plus。

參考資料

• Codex 官方排查頁 — https://learn.chatgpt.com/docs/reference/troubleshooting
• OpenAI API 錯誤碼 — https://developers.openai.com/api/docs/guides/error-codes
• OpenAI 幫助中心：網絡建議 — https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps
• OpenAI 狀態頁 — https://status.openai.com/