文档核实日期：2026 年 10 月 16 日。官方页面为持续更新的技术文档，未标注固定发布日期。

先判断是否值得重试

Google 的 Gemini 排障指南建议，对超时、网络问题和临时服务故障使用指数退避；429、408 或部分 5xx 属于可重试的情况。参数错误、权限问题及计费问题应先修复原因。官方 SDK 已包含部分自动重试逻辑，接入前要确认当前版本的行为。

可以照着执行的顺序

  1. 记录一次完整失败。 保留模型名称、SDK 版本、状态码、请求持续时间和经过脱敏的错误信息。区分服务返回错误与本地等待超时。
  2. 检查重复重试。 查清 SDK、业务代码和任务队列各自会重试几次，避免多层叠加，让一个请求变成大量调用。
  3. 逐步延长间隔。 可从约 1 秒开始，按 2 秒、4 秒等方式增加等待，并加入少量随机延迟，减少多个客户端同时再次请求。
  4. 设定停止条件。 到达最大尝试次数或总等待时间后，保留错误并返回明确状态，让使用者决定是否稍后再试。

本文的排查顺序为本站整理。对会写入业务数据的任务，重新执行前还应核对上一次是否已完成，避免重复提交。

来源：Google：Gemini API Troubleshooting guide。