---
title: "Mac 上的 There was a problem communicating with the secure web proxy server (HTTPS)（CFNetwork 错误 310）· Kilobat 指南"
url: "https://kilobat.app/zh-hans/guides/cfnetwork-error-310-problem-communicating-with-the-secure-web-proxy-server"
description: "App 失败，提示 There was a problem communicating with the secure web proxy server (HTTPS)，即 CFNetwork 错误 310。请修正代理设置。"
---

# 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 连不上的原因](https://kilobat.app/zh-hans/guides/recipes/why-cant-it-connect)。

## 常见问题

**306 是什么？**

306 是网页代理 (HTTP) 对应的同一条消息。参见“代理”列表中的 HTTP 代理一行。

**为什么许多 App 会同时失败？**

它们使用同一个系统代理。

## 参考资料

- CFNetwork.framework 中的错误文字，macOS 27.2（Localizable.loctable）
- curl(1) 和 nc(1)，macOS 27.2 自带的 man 手册页

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

## 相关指南

- [Mac 上出现“Safari 浏览器无法连接到 Web 代理服务器”](https://kilobat.app/zh-hans/guides/safari-cant-connect-proxy-server): 网络设置中设定了 Web 代理，而 Safari 浏览器无法连接到它。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
- [Mac 上公司代理证书导致“终端”工具出错](https://kilobat.app/zh-hans/guides/corporate-proxy-certificates): 一些公司网络会检查 HTTPS 流量。
- [Mac 上内容过滤器屏蔽了网站](https://kilobat.app/zh-hans/guides/content-filter-blocking): 内容过滤器会检查网页流量并阻止某些网站。
