修复 Gemini CLI 预览模型 404 报错，自动降级至稳定版

alarcritty · ghdev · 2026-08-01

针对 Gemini CLI 中 API 密钥身份验证用户遇到预览模型 404 报错的问题，该 PR 引入了优雅降级机制。

问题背景：系统此前默认所有 API 密钥均拥有预览模型访问权限。当无权限的密钥调用 gemini-3.1-pro-preview 时会触发 404 错误，且随后的备选策略仍会尝试其他预览模型（如 gemini-3-flash-preview），导致连续报错并弹出无关的管理员提示。
修复方案：在备选处理逻辑中，若检测到 API 密钥路径下的预览模型出现 404 错误，系统会记录该密钥无预览权限，并自动将备选模型解析为稳定版（gemini-2.5-pro 和 gemini-2.5-flash），同时显示针对 API 密钥用户的专属提示信息。
测试验证：已添加覆盖访问降级、OAuth 认证、非预览模型等边界情况的单元测试，并成功通过了端到端模拟验证。

「编程与Agent」频道最新