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 error 310)。请阅读 https://kilobat.app/zh-hans/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 自带的 man 手册页

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