Mac 上的「There was a problem communicating with the secure web proxy server (HTTPS)」(CFNetwork 錯誤 310)

Mac 設定為使用 HTTPS 代理伺服器,而該代理伺服器無法運作。所有遵循系統代理伺服器設定的 App 都會失敗。

讓你的代理程式來解決拷貝一則提示詞,適用於 Claude Code、Codex 或任何能使用終端機的代理程式。

我的 Mac 出現了這個問題:Mac 上的「There was a problem communicating with the secure web proxy server (HTTPS)」(CFNetwork 錯誤 310)。請閱讀 https://kilobat.app/zh-hant/guides/cfnetwork-error-310-problem-communicating-with-the-secure-web-proxy-server.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:macOS 13 Ventura 以上版本。文字已在 macOS 27.2 的 CFNetwork 中核對。檢查日期:2026年10月29日

症狀

  • App 顯示「There was a problem communicating with the secure web proxy server (HTTPS).」
  • 「主控台」顯示 kCFErrorDomainCFNetwork Code=310。
  • Safari 顯示「can’t connect to the web proxy server」。

可能原因

  • 代理伺服器已關閉或設定錯誤。代理伺服器的位址或連接埠有誤,或代理伺服器沒有開啟。
  • 來自舊網路的代理伺服器設定。Mac 還保留著公司的代理伺服器。
  • 由設定檔或 App 設定的代理伺服器。VPN 或資安 App 可能會設定它。

如何檢查

  1. 顯示 macOS 使用的代理伺服器設定。

    scutil --proxy
  2. 顯示 Wi-Fi 的安全網頁代理伺服器設定。

    networksetup -getsecurewebproxy Wi-Fi

如何修正

  1. 打開「系統設定」›「網路」›「Wi-Fi」›「詳細資訊⋯」›「代理伺服器」。如果不需要,請關閉「安全網頁代理伺服器 (HTTPS)」。

  2. 如果需要,請和你的管理員一起更正位址和連接埠。

  3. 關閉設定代理伺服器的 VPN 或過濾器 App。

  4. 結束 App,然後重新打開。

使用 Kilobat

  1. 一次檢查 Wi-Fi、路由器、網際網路、DNS 和登入頁面。

    kilobat diagnose
  2. 如果是某個網站或服務失敗,找出擋住它的環節。

    kilobat why example.com
  3. CLI 是免費的。在 App 中,這些檢查提供的建議屬於 Kilobat Pro。請參閱找出某個網站或 API 連不上的原因。

常見問題

306 是什麼?

306 是網頁代理伺服器 (HTTP) 的同一則訊息。請看「代理伺服器」列表中的 HTTP 代理伺服器那一行。

為什麼許多 App 會同時失敗?

它們使用同一個系統代理伺服器。

資料來源

  • CFNetwork.framework 中的錯誤文字,macOS 27.2(Localizable.loctable)
  • curl(1) 和 nc(1),隨 macOS 27.2 安裝的使用手冊頁面

查核日期:2026 年 10 月 29 日。