报错速查表

看到报错先找关键词，再按对应方向排查。

一、API Key 类

报错关键词	可能原因	先看
invalid api key	API Key 错误或失效	API Key 安全
unauthorized	未授权、Key 错误	配置检查清单
401	认证失败	常见报错排查

优先检查：

• Key 是否复制完整
• 是否多复制空格
• 是否填到了正确字段
• Key 是否已经删除

二、余额和额度类

报错关键词	可能原因	先看
insufficient quota	额度不足	充值余额
quota exceeded	超出额度	模型选择教程
balance not enough	余额不足	充值余额
429	限流或请求过多	常见报错排查

三、模型类

报错关键词	可能原因	先看
model not found	模型名错误	模型选择教程
unknown model	模型不存在	配置检查清单
404	模型或接口地址错误	常见报错排查

优先检查模型名称是否和后台完全一致。

四、接口地址类

报错关键词	可能原因	先看
fetch failed	网络或接口地址错误	配置检查清单
connection failed	无法连接接口	常见报错排查
ECONNREFUSED	地址不可访问	终端命令行入门
ENOTFOUND	域名无法解析	常见报错排查

优先检查：

• 是否写了 https://
• 是否少写或多写 /v1
• 是否把网页地址当成接口地址

五、命令行类

报错关键词	可能原因	先看
command not found	命令没装好或 PATH 问题	终端命令行入门
不是内部或外部命令	Windows 找不到命令	使用前环境配置
permission denied	权限不足	终端命令行入门
unsupported engine	Node 版本太低	使用前环境配置

六、项目构建类

报错关键词	可能原因	先看
npm run build 失败	项目代码或配置错误	AI 编程工作流
Cannot find module	依赖缺失	终端命令行入门
Module not found	文件路径或依赖错误	常见报错排查
TypeError	代码运行错误	AI 编程工作流

七、复制给 AI 的排查模板

请根据下面报错帮我定位问题。

我执行的命令：
粘贴命令

完整报错：
粘贴报错

请输出：
1. 报错类型
2. 最可能原因
3. 需要检查的配置
4. 最小修复步骤
5. 修复后如何验证