Cursor 网络连接失败怎么办？模型请求超时与错误排查

排查顺序：从本机到服务端

错误弹窗的文案五花八门（Connection failed / timed out / unable to reach），但故障只会落在五层里。自下而上排，别跳步。

第 1 层：代理覆盖

Cursor 的网络栈不完全等同浏览器，「系统代理开着」不保证它走了代理。

• 最稳方案：客户端开 TUN 模式（虚拟网卡接管全部进程）。
• 次选：Cursor 设置里搜 proxy，显式填 http://127.0.0.1:7897（端口按你的客户端）。

验证：换任一方案后重启 Cursor 再测——代理设置对已建立的连接不生效，必须重启。

第 2 层：HTTP/2 兼容性

国内代理环境的经典坑：Cursor 默认走 HTTP/2，部分代理协议 / 服务端对 HTTP/2 长流处理不佳，请求发出去就石沉大海。

设置中搜索 http2 → 勾选 Disable HTTP/2。这一项对「时好时坏」「一直转圈」类症状的命中率非常高。

第 3 层：节点质量

前两层排除后仍失败或间歇失败：

1. 晚高峰 ping -c 100 当前节点，丢包 > 1% 说明线路拥塞。
2. 换到美国 / 日本的专线节点（Cursor 服务器主要在美国）。
3. 把 cursor.com、cursor.sh 固定到该节点，关闭自动切换。

节点标准的完整讨论见 Cursor 用什么节点比较稳定。

第 4 层：本机拦截

• Windows 安全软件 / 防火墙可能拦 Cursor 主进程或 TUN 虚拟网卡——放行两者。
• 装过多个代理工具的机器注意端口冲突与残留的系统代理设置。

第 5 层：服务端

一切正常却全网报错：查 Cursor 官方状态页（status.cursor.com）。服务端故障与高峰限流不归你管，等待即可；免费档的慢速队列在高峰期排队也属正常。

两个特殊场景

• 公司网络：SSL 深度检测会伪造证书导致握手失败，表现为持续的证书 / 连接错误。解决：导入企业根证书、请 IT 放行，或长任务改在家庭网络跑。
• 只有某个模型失败：Claude 可用而 GPT 失败（或反过来）不是连接问题，是模型侧问题，见 Cursor Claude / GPT 模型无法使用怎么办。

症状是「不报错但永远转圈」的，另见 Cursor 为什么一直转圈；跨工具的断线通用排查见 AI 编程工具经常断线怎么办。