错误信息

Mac 上提示“请求超时。”（The request timed out.）

这是 macOS 中错误 -1001 的提示文本。App 一直在等待响应，直到超时。路径中有某个环节很慢或在丢弃流量。

适用于：所有当前的 macOS 版本。networkQuality 需要 macOS 12 或更高版本。提示文本已在 macOS 27.2 上核对。核查日期：2026年10月29日

症状

App 显示“请求超时。”
App 可能会显示 NSURLErrorDomain 和 -1001。
只在某个网络上出现，或在开启 VPN 时出现。

可能的原因

连接慢或丢包。Wi-Fi 信号弱、热点繁忙或丢包都会延迟响应。
IPv6 路径故障。App 先尝试 IPv6，而 IPv6 不通。
防火墙丢弃了流量。防火墙直接丢弃流量而不是拒绝连接时，就会造成超时。
代理或 VPN。慢或无法访问的代理会卡住请求。
服务器慢。如果所有网络都失败，就是服务器响应太慢。

如何检查

测量连接及其响应能力。
```
networkQuality
```
ping 一个互联网上的地址。这项测试不会用到 DNS。
```
ping -c 5 1.1.1.1
```

为一次请求的每一步计时。使用 App 所用的地址。

curl -o /dev/null -s -w 'dns %{time_namelookup}  connect %{time_connect}  tls %{time_appconnect}  total %{time_total}\n' https://example.com

只尝试 IPv4。如果这样很快，问题就出在 IPv6 路径上。
```
curl -4 -I https://example.com
```
显示系统代理设置。
```
scutil --proxy
```

如何修复

靠近路由器，或改用以太网。
暂停 Mac 上的大型上传和下载。请参阅找出 Mac 上占用带宽的 App。
如果 IPv4 正常而 IPv6 不正常，请阅读Mac 上的 IPv6 问题。
如果设置了你并不使用的代理，请将其移除。请参阅代理设置导致 Mac 上的 App 无法连接。
如果打开了 VPN、代理或安全 App，请暂时关闭它进行测试，测试后再重新打开。

使用 Kilobat

Kilobat 的连接诊断会逐层测试该网站：网络、代理、DNS、规则、IPv4、IPv6、TLS 和服务器，并指出失败的那一层。
```
kilobat why https://example.com
```
显示某个 URL 的 DNS、连接、TLS 和首字节时间。
```
kilobat http-check https://example.com
```
Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用 diagnose_connection 和 diagnose_network 运行它们。请参阅找出某个网站或 API 连不上的原因。

常见问题

NSURLErrorDomain -1001 是什么？

这是 Apple URL Loading System 中的 timedOut 错误。Apple 将其描述为异步操作超时。

参考资料

CFNetwork.framework 中的错误文字，macOS 27.2（Localizable.loctable）
Apple 开发者：URLError.Code timedOut (-1001)
Apple 支持：使用 Apple 网络响应性测试 Wi-Fi 网络
curl(1)、ping(8) 和 networkQuality(8)，macOS 27.2 自带的 man 手册页

参考资料核查于 2026年10月29日。man 手册页为 macOS 自带版本；在“终端”中用 man <name> 打开。