AI 常见报错排查大全

这篇整理新手最常见的问题。遇到报错时，不要急着乱改，先看报错属于哪一类。

一、API Key 无效

常见提示：

invalid api key
unauthorized
401

排查：

• API Key 是否复制完整
• 是否多复制了空格
• Key 是否被删除
• 工具里选的服务商是否正确

二、余额不足

常见提示：

insufficient quota
quota exceeded
balance not enough

排查：

• 后台余额是否充足
• 当前 Key 是否属于正确账号
• 是否使用了价格较高的模型

三、模型不存在

常见提示：

model not found
unknown model
404

排查：

• 模型名称是否和后台完全一致
• 是否把显示名当成模型 ID
• 当前账号是否有该模型权限

四、Base URL 填错

常见提示：

connection failed
not found
fetch failed

排查：

• 地址是否少写 https://
• 是否少写或多写 /v1
• 是否把网页地址当成接口地址
• 工具是否需要 OpenAI 兼容接口

五、命令找不到

常见提示：

command not found
不是内部或外部命令

排查：

• 是否安装成功
• 是否重新打开终端
• npm 全局目录是否加入 PATH

常用检查：

node -v
npm -v
npm list -g --depth=0

六、Node 版本太低

常见提示：

unsupported engine
requires node >= 20

排查：

node -v

如果版本太低，回到 使用前环境配置 安装新版 Node.js。

七、npm install 失败

排查：

• 网络是否正常
• 是否使用了管理员权限
• Node/npm 版本是否过低
• 是否有代理或镜像配置问题

可以先尝试：

npm cache verify

八、AI 改完后页面打不开

排查：

npm run build
npm run dev

如果构建失败，把报错复制给 AI：

我运行 npm run build 报错了。请根据下面报错定位原因，并给出最小修复方案。