Cursor用户经常遇到的“连接失败”问题，通常与HTTP/2协议的网络兼容性有关。在公司内网、VPN或使用代理（如Zscaler）等环境下，HTTP/2可能被拦截或连接不稳定，导致Cursor无法正常工作。幸运的是，Cursor提供了HTTP/1.1的备用方案。只需在Cursor设置中禁用HTTP/2，即可强制使用HTTP/1.1，避开网络兼容性问题，从而解决连接失败的问题。虽然禁用后响应速度会稍慢，但能保证连接的稳定性。

⚠️ “Connection failed”报错通常与Cursor依赖的HTTP/2协议有关，尤其在公司内网、VPN或使用代理时容易出现。

⚙️ 解决办法是关闭HTTP/2，强制Cursor使用HTTP/1.1。具体步骤：打开Cursor设置 -> VS Code Settings -> 搜索http2 -> 勾选“Disable HTTP/2”选项。

📶 禁用HTTP/2后，Cursor响应速度会略微变慢，但可以有效避免频繁断开连接的问题，提高使用稳定性。

最近在使用 Cursor 的过程中，时不时会遇到这样一条报错：

“Connection failed. If the problem persists, please check your internet connection or VPN”
（连接失败。如果问题持续出现，请检查你的网络或 VPN 设置）

这个提示通常出现在没有任何征兆的情况下，即使你的网络连接一切正常，也有可能突然断掉，影响使用体验。

问题出在哪里？

Cursor 的许多 AI 功能依赖 HTTP/2 协议，因为它支持流式响应。然而，并不是所有网络都支持 HTTP/2，尤其是在以下场景下：

公司或内网环境

使用 VPN

走代理，例如 Zscaler

一旦 HTTP/2 被拦截或连接不稳定，Cursor 就可能无法索引代码，也无法正常调用 AI，最终导致连接失败的错误提示。

解决办法：关闭 HTTP/2

幸运的是，Cursor 已经提供了 HTTP/1.1 的备用方案。虽然它的速度略慢，但在不稳定网络下，反而更可靠。

你可以按照下面的步骤来开启：

打开 Cursor 设置（快捷键 Cmd 或 Ctrl + ,）

进入 VS Code Settings

搜索关键词 http2

勾选  “Disable HTTP/2”  选项

这样就会强制 Cursor 使用 HTTP/1.1，从而避开网络兼容性问题。

✅ 设置完成后，连接错误大多会消失，使用起来也顺畅多了

不过，禁用 HTTP/2 后，Cursor 的响应速度会稍微慢一点，不过，至少不会再出现一直断开链接的情况了，希望 Cursor 能够早点修复这个问题。

参考资料

Cursor 官方论坛：关于连接失败的讨论

Cursor 官方文档：网络连接问题（HTTP/2）