
Gemini CLI 429 报错怎么解决:5 步排查到恢复
Gemini CLI 报 429 不是账号被封,是请求频率或配额超限。先看报错信息:如果包含 RESOURCE_EXHAUSTED 和 You exceeded your current quota,基本就是免费额度用尽或每分钟请求数(RPM)超了。解法按顺序试:查用量、切模型、加节流、等重置。
现象:先对号入座
在终端跑 gemini 时看到这些提示,都属于 429:
- 429 Too Many Requests
- RESOURCE_EXHAUSTED,You exceeded your current quota
- Quota exceeded for metric: generate_content_free_tier_requests
报错信息里经常附带两个关键信息:超限的指标名(free_tier_requests 代表免费层每日请求数超限)和需要等待的秒数(Please retry in 54s 这类提示)。

原因:429 是怎么来的
- RPM 限流:每分钟请求数超限。Gemini API 配额从 RPM(每分钟请求数)、RPD(每日请求数)、TPM(每分钟 token 数)、TPD(每日 token 数)四个维度衡量,任一超限都触发 429,免费层各模型配额独立,不能混用余量。
- 免费额度用尽:免费层级按天计且不可叠加,当天用完次日重置。
- 并发过密:脚本循环或 CLI 多开同时发请求,短时间内把配额打满。
解法:按原因逐条处理
- 确认配额:浏览器打开 ai.dev/usage?tab=rate-limit 看当前用量和限额,AI Studio 里也能查。
- 切模型:在 CLI 里用 /model 切到 Flash-Lite 或 Flash。轻量模型配额池独立、限额更高,很多 429 切个模型就绕过去了。
- 客户端限流:脚本里每次请求间隔 1 到 2 秒;CLI 里别连续回车追问,给上一次请求留出完成时间。
- 等待重置:免费额度按天重置,通常第二天恢复;报错写明 Please retry in Ns 的,按秒数等。
- 申请提额:AI Studio 里申请 quota increase,需要绑定结算账号并开启两步验证。
- 切换认证:官方报错原文给了两个方向,申请提额,或 switch to another /auth method,换一种登录方式也等于换一套配额。
官方口径

谷歌官方限流文档说明:配额从四个维度衡量,超出任何一项都会返回 429。Gemini CLI 的 429 提示会引导用户去 AI Studio 处理,这是正常的用量控制,不是账号异常。社区报错原文示例见Gemini CLI 仓库 Issue #6126。
预防:下次怎么避免
- 脚本加重试加退避:429 后等 1 秒再试,指数退避更稳。
- 跟踪用量:定时看 ai.dev/usage,配额快满前停一停。
- 错峰:把批量任务安排在免费配额重置之后。
- 分清报错:429 是频率问题,401 是认证问题,local proxy failed 是网络问题,别混在一起排查。

相关阅读
- Gemini CLI 使用教程:从安装到跑通第一个项目
- Gemini CLI 免费额度:每天 1000 次怎么拿
- Gemini CLI MCP 配置:一条命令5步接好
- Gemini CLI settings.json 怎么改:字段与层级
作者:AI345
最后更新时间:2026 年 10 月
常见问题
429 是不是被封号了?
不是。429 是标准的配额控制,报错原文明确提示 You exceeded your current quota,按本文解法处理即可,账号本身没有问题。
免费额度多久重置?
免费层级按天计且不可叠加,通常第二天重置。部分模型报错会给出 Please retry in Ns 的具体秒数,按提示等待即可。
怎么查我现在的配额?
浏览器打开 ai.dev/usage?tab=rate-limit,可以看当前项目的用量与限额;AI Studio 的设置页里也能看到同一份数据。
切换模型有用吗?
有用。免费层各模型配额池独立,比如 Pro 和 Flash 的 RPM 限额不同,切到 Flash-Lite 或 Flash 通常能直接绕过 Pro 的限流。
429 和 401 有什么区别?
429 是频率或额度超限,401 是身份认证没通过。两者报错都会中断请求,但排查方向完全不同,429 查配额,401 查 Key 和登录状态。
申请提额要花钱吗?
申请本身免费,但需要绑定结算账号并开启两步验证,审核通过后才有更高配额。免费层级不绑定银行卡也能用,只是额度低。

京ICP备2024094994号-29