Mac 上的“There was a problem communicating with the secure web proxy server (HTTPS)”(CFNetwork 错误 310)
Mac 设置了使用 HTTPS 代理,而这个代理无法工作。所有遵循系统代理的 App 都会失败。
我的 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 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。
症状
- 某个 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 可能会设置代理。
如何检查
显示 macOS 使用的代理设置。
scutil --proxy显示 Wi-Fi 的安全网页代理设置。
networksetup -getsecurewebproxy Wi-Fi
如何修复
打开“系统设置 › 网络 › Wi-Fi › 详细信息 › 代理”。如果用不到,请关闭“安全网页代理 (HTTPS)”。
如果需要它,请和管理员一起更正地址和端口。
关闭设置了代理的 VPN 或过滤器 App。
退出该 App,然后重新打开。
使用 Kilobat
一步检查 Wi-Fi、路由器、互联网、DNS 和登录页面。
kilobat diagnose如果某个网站或服务连不上,找出阻断它的环节。
kilobat why example.comCLI 免费。在 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 日。