Gemini API Key 无效：错误讯息与排查流程

调用提示 API_KEY_INVALID 或 400 Invalid Argument？排查空格污染、项目被停用与环境变量加载失败等低级失误。

一、报错提示的标准形态

当调用接口返回 HTTP 400 状态码并伴随如下 JSON 时：
"error": { "code": 400, "message": "API key not valid. Please pass a valid API key.", "status": "INVALID_ARGUMENT" }
这明确说明谷歌网关无法识别你当前提供的身份凭据。

二、四大最常出现的排错清单

1. 复制时多带了前后空格或隐藏字符：在粘贴密钥时首尾不小心带上了空格，导致哈希校验失败；
2. 环境变量读取为空：代码中尝试读取 process.env.GEMINI_KEY，但 .env 文件中定义的是 GEMINI_API_KEY，导致实际向服务端传递了 undefined；
3. URL 传参格式有误：使用 REST 直接调用时，漏写了 ?key= 前缀；
4. 对应 Google Cloud 项目已被删除或停用：在控制台核对该密钥绑定的项目状态是否仍处于 Active 正常运行状态。
重新生成密钥请参考：[Google AI Studio 密钥管理](https://aihuiyuan.club/articles/gemini-api-key-google-ai-studio-free)。