五分钟搞懂 OpenCode 提示 Not Found 错误:原因 + 解法全在这
五分钟搞懂 OpenCode 的 Not Found 错误:原因 + 解法全在这 上周一个关注我的读者私信说,他用 OpenCode 接自己公司的私有 API 中转,跑了两天都好好的,第三天突然就报 AI_APICallError: Not Found ,百思不得其解。 他翻了官方文档,没找到直接的解释。又去 GitHub Issues 搜了一圈,发现同款问题的帖子超过 30 个,但答案散落四处,有人说改配置,有人说清缓存,有人说换模型,搞得他更迷糊了。 我觉得这个错误值得好好说一说,因为我自己也踩过,而且踩的姿势和他完全不同。 Not Found 这仨字看起来简单,背后其实有好几种完全不同的根因,乱试一通只会浪费时间。 今天就把我整理的排查思路写出来,对号入座,五分钟解决。 OpenCode 提示 Not Found 错误 先说结论:Not Found 来自三个方向 在正式展开之前,我想先给你一个整体框架,不然看到后面容易乱。 OpenCode 报 Not Found ,本质上是它向 AI 服务商发出的请求,被对方服务器回了一个 404。原因归纳起来就三类: 接口路径配错了 :你填的 baseURL 不对,请求打到了不存在的路由上 模型 ID 写错了 :格式不符合规范,服务商找不到对应模型 本地缓存过期 :provider 包版本太老,跟不上 API 变更 90% 的情况都在这三类里。下面逐一拆解。 原因一:baseURL 路径写错了(最高频) 这是我见过最多人踩的坑,也是最难发现的一个。 很多人用 OpenCode 接私有部署的 API 中转,或者接 OpenRouter、Aiberm 之类的代理服务,需要在配置里填一个自定义的 baseURL 。问题就出在这里——你填的 URL 末尾有没有斜杠、路径层级对不对,差一点都会报 Not Found。 先看一个配置案例: { "$schema": "https://opencode.ai/config.json", "provider": { "opencode": { "models": { "DeepSeek V4 ...