Mac 上的“Could not connect to the server”(NSURLErrorDomain -1004)

App 找到了服务器的地址,但连接没有打开。服务器拒绝了连接,或者路径上有设备阻止了它。

让你的智能体来解决拷贝一条提示词,适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题:Mac 上的“Could not connect to the server”(NSURLErrorDomain -1004)。请阅读 https://kilobat.app/zh-hans/guides/nsurl-error-1004-could-not-connect-to-the-server.md,并和我一起逐步处理。如果缺少 Kilobat CLI,请安装:brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于:macOS 13 Ventura 及更高版本。文本已在 macOS 27.2 的 CFNetwork 中核对。核查日期:2026年10月29日

症状

  • 某个 App 显示“Could not connect to the server.”,错误为 -1004。
  • 控制台或日志中显示 NSURLErrorDomain Code=-1004。
  • Safari 显示类似的消息“can’t connect to the server”。

可能的原因

  • 服务器已宕机或没有监听。该端口上没有任何程序接受连接。
  • 本地服务器没有运行。对于 localhost,必须运行你自己的服务器。参见Mac 上端口已被占用。
  • 防火墙、过滤器、VPN 或代理。有设备阻止了该端口或主机。
  • 地址或端口不对。App 使用了旧的 URL。

如何检查

  1. 用 5 秒超时测试端口。

    nc -vz -G 5 example.com 443
  2. 请求该页面,并显示连接的每一步。

    curl -v -o /dev/null https://example.com
  3. 对于本地地址,查看监听该端口的程序。

    lsof -nP -iTCP:3000 -sTCP:LISTEN

如何修复

  1. 在另一台设备上打开同一个地址。如果在那里也失败,原因就在服务器或网络。

  2. 启动本地服务器,并使用它打印出的端口。

  3. 测试时关闭 VPN、代理或过滤器,之后再打开。

  4. 检查 App 中的 URL 主机和端口是否正确。

  5. 稍后再试。繁忙的服务器可能会恢复。

使用 Kilobat

  1. 一步检查 Wi-Fi、路由器、互联网、DNS 和登录页面。

    kilobat diagnose
  2. 如果某个网站或服务连不上,找出阻断它的环节。

    kilobat why example.com
  3. CLI 免费。在 App 中,这些检查给出的建议属于 Kilobat Pro。请参阅找出某个网站或 API 连不上的原因。

常见问题

-1004 与 -1001 有什么不同?

-1004 是连接被拒绝或被阻止。-1001 是超时。参见Mac 上的“The request timed out.”。

为什么 localhost 会出现 -1004?

该端口上没有任何程序在监听,或者服务器监听的是另一个地址。

参考资料

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

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