上周写代码写一半Cursor 突然弹出一条红底白字的报错Model not available。我当时第一反应是切个模型重试结果换了 GPT 也报错重启客户端还是报错折腾了二十多分钟才定位到问题。后来我把过去半年在 Cursor 上踩过的类似坑整理了一遍发现这个报错远比表面看起来复杂得多。今天就按排查顺序把完整的解决链路写出来尤其是国内网络环境下遇到这个问题的朋友建议从头到尾过一遍能省下不少瞎折腾的时间。1. 先弄明白 Model not available 到底是什么级别的报错1.1 一句话概括这是一条兜底报错Cursor 本质上是一个套了 IDE 外壳的 AI 客户端后端接的是 OpenAI、Anthropic、Google 多家模型供应商的接口。当你发出一个问题时请求链路大致是Cursor 客户端 - Cursor 网关 - 具体模型供应商。这条链路上任何一个环节出问题客户端都可能给你弹一句 Model not available。这就好比你去饭店点菜服务员只说一句这道菜没有。至于到底是后厨没食材、厨师下班了、还是菜单印错了你完全不知道。Cursor 的报错就是这样它把所有失败原因统一收敛成一个提示不会明确告诉你具体是哪一环断了。所以排查的核心思路不是针对报错本身而是把链路逐段隔离找到真正出问题的那一段。1.2 我把常见根因分成了四类结合国内外用户的反馈以及我自己在不同环境下的实测常见的根因基本跑不出下面四类根因类别典型表现发生率服务端故障官方状态页显示 API 或 Models 异常中账号侧问题订阅到期、免费额度耗尽、请求频率超限高本地客户端异常缓存损坏、版本太旧、系统时间偏差高网络链路波动请求超时、连接被强制断开、DNS 解析慢中高有意思的是很多人遇到这个报错第一反应就是是不是我的账号被封了实际上我遇到的情况里本地客户端异常和网络波动占了大头账号原因反而是最不常见的。下面按从易到难、从远端到本地的顺序展开。2. 第一轮排查服务端状态、订阅额度、版本号2.1 先看官方状态页省得自己折腾半天是别人机房的事排查任何 Cursor 问题我习惯第一步先打开status.cursor.com。这个页面会实时显示 Cursor 各个服务的运行状态包括 API、IDE Extension、Models、Web App 等。如果状态页上API 或者 Models 显示 Major outage / Degraded performance那就基本不用往下查了——是官方机房的事你本地怎么折腾都没用等恢复就行。这种时候你还能做的是去 X 或者 GitHub 上搜一下 Cursor down确认是不是全球范围内大面积报错如果别人也这样直接切到 Web 版或者其他工具临时顶着订阅状态页的邮件通知恢复后第一时间收到提醒。这里有个小经验状态页显示的未必百分百准确官方有时候会延迟更新状态。如果你发现状态页全绿但身边好几个朋友同时报错那大概率是某个区域节点出了只影响部分地区的路由问题这时候可以等半小时再重试。2.2 订阅到期与免费额度耗尽最容易伪装成这个报错我遇到过两次 Model not available都是因为免费版额度用完了。Cursor 的免费套餐每个月会给一定次数的Fast Requests快速请求用完之后并不会直接停摆而是给你塞进Slow Requests慢速请求的队列。但如果慢速队列本身就排队严重或者当前空闲算力不足你的请求就有可能在网关层直接被拒绝然后客户端翻译成一句笼统的 Model not available。查看方法也很简单打开 Cursor 设置进入Settings - Account确认当前登录账号和订阅状态进入Settings - Usage查看 Fast Requests 剩余次数如果你用的是 Cursor Pro确认它显示的期限还没有过期绑定的支付方式没有失效。如果发现确实是额度用完了解决路径就两条等下一个计费周期重置或者升级到 Cursor Pro 拿更多快速请求额度。这里提醒一句不要想着用切换账号的方式无限薅免费额度Cursor 风控对这类行为非常敏感轻则限流重则封号。锁号进程一旦启动你看到的报错就不只是 Model not available 了而是各种永久性的账号异常。2.3 老版本客户端会被服务端拒绝模型请求Cursor 的发布节奏非常快几乎每周都有新版本。如果你安装之后几个月没更新老版本客户端里的模型路由表大概率已经和官方网关对不上了这时请求新模型就会返回 Model not available。更新方式有两种在 Cursor 菜单栏点击Help - Check for Updates按提示重启直接去官网下载最新安装包覆盖安装这种方式的优点是升级干净利落不会因为增量更新的残留文件导致后续奇怪问题。我建议国内用户优先用第二种方式因为 Cursor 的自动更新服务在国内网络环境下偶尔会卡住下载完安装包却校验失败客户端就停在半新不旧的版本上反而更麻烦。下载安装包的时候注意选对应系统的版本Windows 用户选 x64 或者 arm64 别弄错。如果你用公司统一派发的电脑可能 IT 做了软件分发策略导致你用的还是很久以前的版本。这种情况找 IT 申请更新或者直接下绿色版官方安装包选择 portable 模式解压到本地目录用不需要管理员权限。3. 第二轮排查让本地客户端回到干净状态3.1 重载窗口与全量退出解决会话卡死如果服务端和账号都没问题那问题大概率出在本地客户端上。第一个动作不是重装而是重载窗口。在 Cursor 里按CtrlShiftPmacOS 是CmdShiftP打开命令面板输入Reload Window回车。这个操作等价于把整个 IDE 界面无痕重启会释放掉一些卡死的后台线程和异常的服务连接。很多临时性的 Model not available 到这里就消失了。如果重载窗口也没用那就全量退出客户端。这里注意一个细节直接点窗口右上角的红叉Windows或者关掉窗口macOS进程不一定真的结束很多后台进程还驻留在内存里。正确做法是Windows右键系统托盘的 Cursor 图标选择退出或者打开任务管理器把所有 Cursor.exe 进程全部结束macOS按CmdQ退出然后打开活动监视器确认没有残留的 Cursor 进程。等 5 到 10 秒再重新打开让 Cursor 重新建立到网关的 WebSocket 连接。很多时候无限转圈一直 reconnecting这类问题也会在这种全量重启后消失。3.2 删除本地缓存和配置文件让客户端回到干净状态如果重启进程还不行下一步就要清理缓存了。Cursor 底层是基于 VS Code 改的继承了 Electron 应用的通病时间一长本地缓存里的索引数据、会话数据、模型路由缓存可能会损坏一旦损坏客户端请求模型时拿到错误的路由信息就会表现出模型不可用。清理方法是先备份再删除Windows 下打开%APPDATA%\Cursor目录macOS 下打开~/Library/Application Support/Cursor目录。进去之后你会看到一堆Cache、CachedData、Code Cache、GPUCache之类的文件夹还有globalStorage、workspaceStorage等。不要直接删整个目录那样你的登录态、设置、密钥全部没了还得重新折腾一遍。我通常只删这几个CacheCachedDataCode CacheGPUCacheService Worker/CacheStorage如果需要更彻底一点可以删掉globalStorage里面 Cursor 自己的状态文件夹不是整个 globalStorage这样登录态会丢需要重新扫码登录但配置还能保留。删完之后重启 Cursor你会发现第一次启动时右下角会有索引重建的提示等它跑完再试一次聊天窗口。这个方法我至少成功救回过三次看似无解的模型报错。3.3 系统时间偏差会导致 HTTPS 握手失败这是一个非常隐蔽但极其常见的原因尤其出现在装了双系统或者长时间不关机的机器上。Cursor 客户端和官方网关之间走的是 HTTPS 加密连接TLS 握手过程中客户端会校验服务器的证书同时服务器也会校验客户端的时间戳签名。如果你系统时间跟真实时间偏差超过几分钟握手就会失败。但 Electron 应用在这种情况下不一定会报证书错误很多时候只会表现为请求发不出去一直重连模型不可用。排查方法很直接Windows右键任务栏时间 - 调整日期和时间确认自动设置时间是开的macOS系统设置 - 通用 - 日期与时间打开自动设定。如果你开了自动同步还是不对劲可以手动触发一次时间同步。Windows 在命令提示符里执行w32tm /resyncmacOS 下可以关掉再打开自动设定强制同步一次。这个坑我为什么单独拎出来说因为在线论坛上很多人给出删缓存重装的建议把问题复杂化了实际就是开机时主板电池没电或者双系统切换导致时间被改到了 2015 年。你先看一眼系统时间再决定要不要走重装的弯路。4. 第三轮排查模型路由与网络可达性4.1 确认 Cursor 依赖的接口域名在本地能否正常连通如果说前两轮排查是内政那这一轮就是外交——需要确认你的本地网络到 Cursor 服务端之间的链路是不是通的。Cursor 依赖的接口域名大概有这么几个cursor.comapi2.cursor.shapi3.cursor.shapi4.cursor.shdownload.todesktop.com客户端更新专用在 Windows PowerShell 里可以用Test-NetConnection api2.cursor.sh -Port 443如果返回TcpTestSucceeded : True说明能连通如果返回False说明你的网络到该域名的 443 端口的 TCP 握手是失败的。macOS 或 Linux 下可以用nc -vz api2.cursor.sh 443另外更直观的办法是直接用浏览器访问 https://cursor.com如果能打开官网首页说明基础连通性没问题问题可能出在 Cursor 客户端和网关之间的 WebSocket 连接上。这种时候可以试试在 Cursor 里执行命令面板的Developer: Toggle Developer Tools切到 Console 看有没有明显的请求报错。需要说明的是国内网络环境访问海外服务时因为国际出口带宽有限高峰期出现超时、丢包并不稀奇。这不是你的电脑坏了也不是 Cursor 把你拉黑了就是单纯的链路抖动。你要做的是判断这个问题是长期存在还是临时抽风。4.2 用请求特定模型的方式绕过故障路由有时候报错并不是所有模型都不可用而是当前默认路由到的那个模型出了问题比如你默认用的某个模型正好在高负载状态网关拒绝新增请求。解决办法是强制客户端走另外的模型。操作方式有两种点击右下角齿轮图标进入Models面板切换一个不同的模型比如把 Claude 系列切到 GPT 系列或者反过来直接在聊天输入框输入模型请求语法格式是Request:模型标识符例如Request:gpt-4o Request:claude-3-5-sonnet具体可用模型标识符以官方文档为准因为 Cursor 支持的模型列表会随版本变化。这个语法会强制本次请求使用指定模型绕开默认路由。如果你在用的是 Tab 自动补全也就是常说的CtrlK / Tab 补全时遇到报错那又不一样。Tab 补全走的是后台模型跟聊天走的不一定是同一个路由池。你可以在设置里搜索 tab 或者 inline suggestions临时关闭自动补全功能等高峰期过了再打开这样至少不耽误主流程写代码。这个方法不算根治但应急非常管用。4.3 运营商和跨地域链路的现实问题怎么应对在国内使用 Cursor必须接受一个现实你的机器和 Cursor 的服务节点之间隔了不止一道运营商关口跨地域链路的延迟、丢包在高峰期都可能上升。遇到报错频繁的时候我一般的应对思路是这样的切换网络环境做对照测试。比如你现在用的是宽带直接开手机热点给电脑上网再试一次同样的问题。如果热点下一切正常说明问题出在宽带运营商到 Cursor 节点之间的路由上不是你电脑的问题错峰使用。国内晚上 8 点到 11 点是国际出口带宽的高峰期这个时间段如果频繁报 Model not available可以试着把重活挪到清晨或者工作时间试试公司网络或者校园网出问题先别瞎折腾。很多企业网络和校园网的上网行为管理设备会拦截非白名单域名的 HTTPS 请求遇到这种情况你自己改配置是没用的直接找网络管理员说明需要访问 Cursor 服务让他们在防火墙上放开对应域名的 443 端口。别觉得麻烦这是最合规也最有效的做法。这里也说明一下我自己不赞成也不建议任何绕过网络限制的操作方式上面说的方法完全基于在合规的前提下通过切换网络环境来判断问题的思路。你买的工具、你付费订阅的服务本来就该在一个通畅的网络条件下正常出结果。5. 隐藏得更深的几个坑多设备、账单地址、Web 版5.1 多设备同时在线会触发会话并发限制有一次我排查了很久没找到问题最后发现是还有一个手机端的 Cursor 页面开着一直占着会话资源。Cursor 对同一账号的同时会话数是有限制的免费版尤其明显。你在笔记本上开着客户端平板上再开一个然后两边同时提问后发的那个请求就可能被判定为超过并发限额返回 Model not available。解决方法是打开 Cursor 官网的账号管理页把不常用设备远程退出登录。如果你跟我一样记性不好经常忘记之前在哪台机器上登过账号这个远程退出功能真是救命。5.2 地区与账单地址影响模型可用性这个属于比较少人提到但真实存在的因素。Cursor 的计费体系是按地区走的账单地址和支付方式绑定的地区会影响你账号能访问的模型列表。有些国家和地区的账号能看到的模型少一截某些新模型全面灰度之前会先限制部分地区访问。如果你之前在设置里随便填了个账单地址或者买账号的时候用过不太准确的信息建议进Billing - Update billing address改成和你的支付方式一致的真实地址。注意这里说的是和支付方式一致的真实地址这样既符合平台规则也能避免因为地址不一致导致的支付校验失败。很多人以为账单地址随便填结果支付失败或者订阅到期后自动续费扣款失败账号被降级成了免费版接下来自然就是报错不断。5.3 用 Web 版快速定位是本地问题还是账号问题这个技巧我觉得是排查效率最高的用同一账号去 Cursor 的 Web 版https://cursor.com 登录后直接用发同样的问题。如果 Web 版完全正常那问题几乎可以锁定在桌面客户端本地重点做缓存清理、重装客户端如果 Web 版也报同样的错那就是账号侧或者服务端的问题你再怎么重装客户端都没用老实去查订阅状态、等待官方恢复。这条对照测试法对国内用户尤其好用因为它能帮你判断出这个故障到底跟本地网络环境有没有关系。有一次我桌面端疯狂报错但 Web 版秒开排查了半小时发现是本地客户端升级到某个测试版后会话文件损坏删缓存重装后解决。如果没有 Web 版这个对照组我可能还要折腾更久。6. 几条我在实际使用中攒下的经验6.1 不要用来路不明的修改版客户端关于 Cursor 破解版 这类东西我只说一句那些帮你去掉付费校验的第三方修改版风险远大于收益。一来它可能在你电脑里植入后门二来官方风控完全能识别出异常客户端签名轻则限流重则整个账号被标记为高风险。到时候你看到的不只是 Model not available而是各种莫名其妙的拒绝服务。老老实实用官方安装包哪怕多花点时间做环境配置也比被后门接管电脑强。6.2 顺手说一下中文界面设置很多人在搜 Cursor 汉化 的时候误打误撞进了这个报错的排查。Cursor 现在官方已经支持中文界面了方法是在设置里找Languages选项选择Chinese (Simplified)或者去扩展商店安装 Chinese (Simplified) Language Pack 扩展重启之后就是中文界面。这和 Model not available 没有任何关系只是提醒你如果主界面改成中文后碰巧又遇到报错别把两件事联想到一起排查思路还是按上面四类根因来走。6.3 最后一个小技巧如果你按照上面几轮排查走完问题还是偶发出现尤其是高峰时段容易报错可以在出现报错时留意一下具体时间点。如果每次都集中在特定时间段比如晚上 9 点到 11 点那基本就是链路压力的客观规律不是你的客户端有什么大病。这种时候我一般就不硬刚了要么切到慢速请求排队等要么干脆用手机热点顶一顶等高峰期过去再切回来。毕竟工具有时候不稳定但你手上的活儿不能停。