Cursor提示模型不可用怎么办？请求失败与连接中断排查

Cursor 提示模型不可用、请求失败或回复中途断开，先看一个关键问题：是所有模型都失败，还是只有个别模型失败。所有模型都失败，通常是网络层问题，比如编辑器没走代理、HTTP/2 连接被代理或安全软件打断、节点不稳定；只有个别模型失败，更多与出口地区、套餐额度、自定义 API Key 或模型临时下线有关。先跑一次网络诊断、换一个模型对照，再按下文逐项排查。

问题现象

• 选择某个模型后提示不可用，或模型列表里看不到它；
• 发送消息后提示请求失败、连接错误，所有模型都一样；
• 回复写到一半停止，提示连接中断或需要重试；
• Tab 补全时有时无，聊天功能正常或反过来；
• 白天正常，晚上频繁失败。

可能原因

快速检查

• 换一个其他模型发送同样的消息，看是否也失败
• 打开 Cursor 设置中的网络诊断（如当前版本提供），看是否有失败项
• 代理客户端的连接日志中能看到 Cursor 相关域名的连接
• 当前节点是手动固定的支持地区节点，没有开启自动测速切换
• 模型设置里没有启用自定义 API Key，或 Key 确认有效
• 在账号页面确认套餐状态和用量
• 查看 Cursor 官方状态页或社区是否有故障公告

详细排查

第一步：区分全部失败还是个别失败

依次切换两三个不同供应商的模型发送简单消息。全部失败，继续第二步查网络；只有个别模型失败，直接跳到第四步。

第二步：确认编辑器走了代理

在代理客户端的连接页面观察，发送消息时是否出现 Cursor 相关域名。没有出现或显示直连，说明编辑器没走代理，按 Cursor 代理设置教程 改用 TUN 模式或编辑器代理设置。

第三步：排查连接中断

能连上但回复中途断开，常见于三种情况：

1. HTTP/2 兼容问题：部分代理、公司网关或安全软件对 HTTP/2 长连接支持不好。新版本在 Cursor 设置的网络相关页面提供 HTTP 兼容模式，可切换为 HTTP/1.1 对照测试（名称以当前版本为准）；
2. HTTPS 扫描：杀毒软件的 HTTPS 扫描或代理的 MITM 功能会打断加密连接，关闭后重试，连接被重置类报错可参考 连接被重置排查；
3. 节点问题：晚上失败率明显更高，就是线路拥堵或丢包，固定一个专线节点。

需要更多信息时，可以通过“帮助”菜单打开开发者工具，在控制台里查看网络报错（菜单位置以当前版本为准）。

第四步：排查个别模型不可用

• 地区：部分模型可能因供应商政策在某些地区不提供，换到另一个支持地区的节点对照，地区相关提示参考 地区不支持报错处理；
• 自定义 Key：关闭模型设置中的自定义 API Key，用 Cursor 自带额度测试；
• 套餐与额度：高级模型的可用范围以 Cursor 官方的套餐说明为准；
• 版本：更新 Cursor 到最新版本，刷新模型列表。

解决方法

1. 编辑器没走代理：开启 TUN 模式，或在编辑器设置中填写代理地址后重启 Cursor；
2. 流式中断：切换 HTTP 兼容模式，关闭 HTTPS 扫描，固定稳定节点；
3. 地区受限：固定使用一个支持地区的节点，Cursor 相关域名全部走同一个策略组；
4. 自定义 Key 问题：修正或关闭自定义 Key；
5. 额度与套餐：查看用量，等待额度重置或调整套餐；
6. 服务端故障：等待官方恢复，期间切换到其他可用模型。

整体网络要求可对照 Cursor 网络要求。

仍然无法解决怎么办

• 换网络对照：用手机热点测试，排除当前宽带或公司网络的限制；
• 换设备对照：在另一台电脑登录同一账号，区分账号问题和本机问题；
• 联系官方支持：附上报错原文、所用模型、Cursor 版本和网络诊断结果，去掉敏感信息后提交。

请在遵守当地法律法规及 Cursor 与各模型供应商服务条款的前提下使用。