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 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。
症状
- 某个 App 显示“Could not connect to the server.”,错误为 -1004。
- 控制台或日志中显示 NSURLErrorDomain Code=-1004。
- Safari 显示类似的消息“can’t connect to the server”。
可能的原因
- 服务器已宕机或没有监听。该端口上没有任何程序接受连接。
- 本地服务器没有运行。对于
localhost,必须运行你自己的服务器。参见Mac 上端口已被占用。 - 防火墙、过滤器、VPN 或代理。有设备阻止了该端口或主机。
- 地址或端口不对。App 使用了旧的 URL。
如何检查
用 5 秒超时测试端口。
nc -vz -G 5 example.com 443请求该页面,并显示连接的每一步。
curl -v -o /dev/null https://example.com对于本地地址,查看监听该端口的程序。
lsof -nP -iTCP:3000 -sTCP:LISTEN
如何修复
在另一台设备上打开同一个地址。如果在那里也失败,原因就在服务器或网络。
启动本地服务器,并使用它打印出的端口。
测试时关闭 VPN、代理或过滤器,之后再打开。
检查 App 中的 URL 主机和端口是否正确。
稍后再试。繁忙的服务器可能会恢复。
使用 Kilobat
一步检查 Wi-Fi、路由器、互联网、DNS 和登录页面。
kilobat diagnose如果某个网站或服务连不上,找出阻断它的环节。
kilobat why example.comCLI 免费。在 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 日。