註冊
ChatGPTCodex

Codex 報「stream disconnected before completion」怎麼辦：連接中途斷開的 5 個排查方向（WebSocket、代理證書、狀態頁）

Codex 回答到一半報 stream disconnected before completion？官方沒有逐字解釋，但幫助中心寫明 Codex 流式輸出走 wss://chatgpt.com/ 的 WebSocket，被網絡或代理攔掉會中斷。本文給出排查順序。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-10-27 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 OpenAI 幫助中心《Network recommendations for ChatGPT errors on web and apps》、Codex 官方文檔（認證、配置參考、排查）整理，資料核對於 2026-10-27。官方沒有專門解釋這條報錯，所以本文寫的是官方文檔裏與「連接中途斷開」相關的做法，不是官方對這句話的逐字說明。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

  • 在 Codex（桌面 App、命令行 CLI 或 IDE 插件）裏讓它幹活，回答到一半彈出 stream disconnected before completion，任務被打斷的人；
  • 只在公司網絡、學校網絡、有代理的網絡裏出現這個問題的人；
  • 想知道「是官方服務故障還是我這邊網絡」的人。

結論先說

按下面的順序試，前兩步 1 分鐘就能做完：

  1. 先看官方狀態頁 status.openai.com。Codex 相關的組件有進行中的事件，就等官方處理，別折騰自己的電腦。狀態頁怎麼讀見 /guides/chatgpt-down-check-status-page。
  2. 把電腦切到手機熱點再試一次。 官方在「How do I know my network is the issue」一節寫了兩個必查項：問題是隻在你這台電腦，還是同一網絡的同事都這樣；以及從公司 WiFi 換成手機熱點後錯誤是否消失。換網絡就好了，問題就在原來的網絡。
  3. 網絡是公司或學校的，就把官方的 WebSocket 要求發給 IT。 幫助中心寫明：ChatGPT 和 Codex 的部分功能除普通 HTTPS 外還用安全 WebSocket；Codex 的模型採樣和流式輸出用的是 wss://chatgpt.com/，需要放行 TCP 443 上的 WebSocket 升級握手。
  4. 有 TLS 檢查、SSL 解密或代理的網絡：官方要求確認這些裝置沒有攔截、改寫或提前關閉 WebSocket 握手和隨後的長連接。命令行 CLI 如果走公司的 TLS 代理，要設定 CODEX_CA_CERTIFICATE。
  5. 都排除後再向官方反饋，附上日誌。

Codex 連接中斷時的對照表：看到什麼、怎麼辦

圖：本站根據 OpenAI 幫助中心：Network recommendations 與 Codex 官方文檔：Authentication 整理的示意圖

報錯原文怎麼讀

完整的提示常常是這個形狀（後面的地址和原因因人而異）：

text
stream disconnected before completion: error sending request for url (...)

按字面意思：回答是一邊生成一邊傳給你的「流」，這條流在結束之前就斷了。冒號後面如果帶 error sending request for url，說明請求發出去的環節就失敗了。官方文檔沒有給這句話下定義，GitHub 的 openai/codex 問題列表裏能搜到不少以這句開頭的反饋，它說明不少人遇到過，但不是官方的解釋，下面的步驟只採用官方文檔寫明的做法。

一、先分清：服務問題，還是自己的網絡

官方幫助中心的建議是在排查網絡前，先看狀態頁有沒有系統性的故障。接着做兩個對比：

檢查怎麼做說明什麼
只是我，還是整個網絡問問同一網絡裏的同事是否也斷線同網絡的人都斷，網絡策略的嫌疑大
公司 WiFi 還是手機熱點同一台電腦切換網絡再試換網絡後恢復，就是原網絡的問題

判斷是服務問題還是自己的網絡，4 步

圖：本站根據 OpenAI 幫助中心：Network recommendations 整理的示意圖

二、公司或學校網絡：讓 IT 放行什麼

幫助中心「WebSocket requirements for ChatGPT and Codex」一節寫的要點（文字是本站轉述）：

  • 如果組織預設阻止 WebSocket 流量，一些功能會卡住、斷開，或者沒法持續接收更新；
  • 需要放行 TCP 443 上的 WebSocket，並確保代理、防火牆或安全網關允許標準的 Upgrade: websocket 握手；
  • 對應關係：ChatGPT 對話更新用 wss://ws.chatgpt.com，Codex 的模型採樣和流式輸出用 wss://chatgpt.com/；
  • 如果防火牆沒法按 URL 路徑放行，就放行到 chatgpt.com 的 443 端口 WebSocket 升級，用於 Codex 流量；
  • 用了 TLS 檢查、SSL 解密、網頁過濾或強制代理的，要確認它們沒有阻止、改寫或過早關閉握手和之後的長連接；如果會話能連上，之後又卡住或斷開，要檢查 WebSocket 的空閒超時和最大幀或消息大小策略。

這幾條是寫給 IT 部門的，個人用戶改不了公司的防火牆。把本文和官方文章的連結發給 IT，比自己折騰更快。

三、有代理或 TLS 檢查：命令行裏設定證書

官方認證文檔「Custom CA bundles」一節：如果你的網絡使用公司的 TLS 代理或私有根證書，在登入前把環境變量 CODEX_CA_CERTIFICATE 設為一個 PEM 證書包；沒設定時，Codex 會退而使用 SSL_CERT_FILE。同一套自定義 CA 設定會用於登入、普通 HTTPS 請求和安全 WebSocket 連接。 官方給的寫法：

shell
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login

證書文件從哪來，要問你們公司的 IT。這條命令是官方原樣給出的，Windows PowerShell 的寫法官方文檔沒有給，不要照抄 export。

四、用了自定義模型提供方：看重試和空閒超時

如果你在 config.toml 裏配置了 model_providers 下自定義的模型提供方（比如公司網關、第三方服務），官方配置參考裏和流式連接有關的字段有：

  • stream_max_retries：SSE 流式輸出被打斷後的重試次數，預設 5；
  • request_max_retries：對提供方的 HTTP 請求重試次數，預設 4；
  • stream_idle_timeout_ms：流式輸出的空閒超時，單位毫秒，預設 300000；
  • supports_websockets：該提供方是否支持 Responses API 的 WebSocket 傳輸。

官方的示例配置裏把重試次數調到了更大的值（stream_max_retries = 10）。這些字段是寫給「自己接模型服務」的人的，用 ChatGPT 帳號直接登入的普通用戶不需要動它們。自定義提供方怎麼配，見 /guides/codex-third-party-models-deepseek-gemini-grok。

五、任務卡住不動，和「斷開」不是一回事

官方排查文檔對「卡住」的建議，也適合先自查：

  1. 看 Codex 是不是在等你批准某個操作；
  2. 打開終端，運行 git status 這樣的基本命令，確認環境正常；
  3. 開一個新對話，用更小、更聚焦的提示重新開始。

任務很長、一次要求改很多文件時，連接中斷造成的損失也更大，把任務拆小是最省事的辦法。

六、反饋時帶上什麼

在輸入框裏輸入 / 可以向官方提交反饋，提交後會拿到一個會話 ID。也可以先到 GitHub 的 openai/codex 搜有沒有相同的問題。官方列出的日誌位置：

  • 會話記錄：$CODEX_HOME/sessions，預設是 ~/.codex/sessions；
  • macOS 應用日誌：~/Library/Logs/com.openai.codex/年/月/日；
  • 命令行登入日誌：直接運行 codex login 時會寫入單獨的 codex-login.log。

分享日誌之前先自己看一遍，確認裏面沒有密鑰、令牌或項目機密。

常見問題

Q：換了網絡就好了，是不是 OpenAI 屏蔽了我的網絡？

官方文檔沒有這麼說。官方寫的是：公司網絡上的安全軟件可能攔截或改寫 WebSocket 流量，需要放行相關域名。是否能用 ChatGPT 取決於所在地區是否在官方支持範圍內，見 /guides/chatgpt-supported-countries。

Q：斷了以後要重新開始嗎？

官方文檔沒有寫這條報錯之後會話是否自動續傳。發生後先看已有的輸出和文件改動，再讓 Codex 接着做，或用 git diff 查看已經改了什麼，見 /guides/codex-getting-started。

Q：是不是額度用完了？

額度用完會有明確的額度提示，和這條連接報錯不是同一類，額度見 /guides/codex-usage-limits。想開通 ChatGPT Plus 可以看 /chongzhi/chatgpt-plus。

Q：登入都有問題怎麼辦？

先看 /guides/codex-cannot-sign-in-send-message-connect。

參考資料

  • OpenAI 幫助中心：Network recommendations for ChatGPT errors on web and apps — https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps
  • Codex 官方文檔：Authentication — https://learn.chatgpt.com/docs/auth
  • Codex 官方文檔：Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
  • Codex 官方文檔：Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
  • OpenAI 狀態頁 — https://status.openai.com/
需要開通或續費？ChatGPT Plus 充值 →

Nathaniel 的更多內容

  1. 01

    Claude 登入報錯對照（帳號被停用以外）：There was an error logging you in、收不到登入電郵、驗證碼、Google 登入的處理

    Claude 登入不上，除了帳號被停用，還有登入出錯、收不到登入電郵、在另一台裝置點連結、想設密碼、Google 登入異常等情況。本文按官方登入幫助整理各提示的原文和處理，帳號被停用另見專門文章。

    Claude0
  2. 02

    Claude 提示「Something went wrong」怎麼辦：限額、消息過長、容量緊張、登入出錯的官方報錯對照

    Claude 報 Something went wrong 或別的錯誤？官方《Troubleshoot Claude error messages》把常見錯誤分成限額、消息過長、登入出錯、容量緊張四類，並給了各自的原文和處理。本文逐項整理，並說明官方沒有單獨解釋籠統的出錯提示。

    Claude0
  3. 03

    DeepSeek 除了「伺服器繁忙」還有哪些報錯：網頁版提示對照和 API 錯誤碼 400、401、402、422、429、500、503

    DeepSeek 報錯不只有伺服器繁忙。本文把官方常見問題裏的網頁版提示（上載失敗、運行環境異常、帳號停用、電郵域名不支持）和 API 錯誤碼匯成對照表，給出官方的原因和處理，並鏈到各篇詳細文章。

    其他 AI 工具0
  4. 04

    Gemini 提示「此帳號無法使用」（Can't access this service）怎麼辦：帳號類型、年齡、Family Link 與工作學校帳號的官方條件

    Gemini 提示 Can't access this service，意思是這個帳號目前不符合使用條件。官方寫明瞭可用的帳號類型、年齡要求和 Family Link 帳號不能用。本文按帳號類型對照，並給出 Something went wrong 的處理。

    Gemini0
  5. 05

    Gemini Pro 免費試用、學生優惠到期後怎麼辦：自動轉付費、重新驗證 SheerID、取消後會失去什麼

    Google AI Pro 學生優惠或試用到期後會怎樣？官方說會自動轉為正常付費的 Plus 或 Pro，會提前通知；沒有按時重新驗證 SheerID 會失去優惠。本文按官方幫助中心整理到期規則、取消後失去的內容和第三方訂閱的處理。

    Gemini0
  6. 06

    Gemini 怎麼切換模型：Flash-Lite、Flash、Pro、Argon 的選擇步驟、思考等級和自動選擇

    Gemini 網頁版怎麼手動切換模型？官方步驟是點聊天框底部當前模型再選，需要有 Google AI 方案，帶鎖圖標的要升級。本文按官方說明整理各方案可選模型、思考等級預設值和自動模型選擇。

    Gemini0

同產品的其他教學

  1. 01

    Codex 常見報錯總表：429、401、登入失敗、連接中斷、缺少環境變量、沙箱、Computer Use、遠程控制，看到哪條讀哪篇

    把 Codex 最常見的報錯和問題匯成一張對照表：429、401、Token exchange failed、stream disconnected、missing environment variable、Windows 沙箱失敗、Computer Use 找不到、遠程控制連不上，各給一句處理方向並鏈到詳細文章。

    ChatGPTCodex0
  2. 02

    Codex 插件在哪裝：桌面 App 的 Plugins 標籤、CLI 的 /plugins、IDE 為什麼沒有，以及插件和技能、MCP 的區別

    Codex 的插件在 ChatGPT 桌面 App 的 Plugins 標籤裏裝，命令行輸入 /plugins，IDE 插件不支持。本文按官方文檔講各入口怎麼裝、裝完怎麼用、用 API 密鑰登入時有什麼限制，以及插件、技能、MCP 伺服器的區別。

    ChatGPTCodex0
  3. 03

    Codex Windows 版怎麼下載安裝：ChatGPT 桌面 App 官方入口、winget 命令、開發工具與 WSL 設定

    Windows 上的 Codex 現在是 ChatGPT 桌面 App 裏的一個入口。官方給了微軟商店下載地址和 winget 安裝命令，原生用 PowerShell 加 Windows 沙箱，也可切到 WSL2。本文按官方文檔講安裝、登入、建議裝的開發工具、管理員運行和常見小問題。

    ChatGPTCodex0
  4. 04

    Codex 遠程控制授權失敗怎麼辦、遠程 SSH 怎麼用：手機配對電腦、Remote Control、連接 SSH 主機的官方步驟

    用手機遠程控制電腦上的 Codex，配對不成功或授權失敗？官方 Remote connections 文檔寫了配對步驟和五類常見問題，也講了怎麼把桌面 App 連到 SSH 主機、怎麼在主機之間交接對話。本文按官方文檔整理，並給出一張排查對照圖。

    ChatGPTCodex0
  5. 05

    Codex 沙箱初始化失敗怎麼辦（Windows）：沙箱設定失敗、錯誤 1385、Everyone 可寫警告與 MXC、elevated、unelevated 怎麼選

    Windows 上 Codex 沙箱設定失敗、命令跑不起來、提示錯誤 1385 或 Everyone 可寫？官方文檔列了常見原因和處理，本文逐項整理，並說明 mxc、elevated、unelevated 三種實現的區別。

    ChatGPTCodex0
  6. 06

    Codex 找不到 Computer Use 怎麼辦：插件在哪裝、地區限制、macOS 權限與 Windows 前台運行說明

    ChatGPT 桌面 App 的 Computer Use 能讓 Codex 看螢幕、點滑鼠、操作桌面應用，但官方寫明它只在支持的地區可用，需要裝 Computer Use 插件並開啟開關。本文按官方文檔講插件在哪裝、macOS 要給哪兩個權限、Windows 為什麼會佔用前台，以及找不到時的排查。

    ChatGPTCodex0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～