故障排除

本页介绍使用 AI Gateway 时的常见问题。有关提供商特定的故障排除，请参阅相关提供商文档。

如果你收到来自 AI 提供商的身份验证错误，说明 AI Gateway 未将有效凭据传递到上游。请检查以下内容：

1. 验证标头位置：确保你的 Cloudflare 令牌位于 cf-aig-authorization 中，而不是 Authorization。Authorization 标头保留给提供商凭据。

2. 根据端点类型检查配置：

   • 提供商专用端点：确认请求 URL 包含提供商路径（例如 /google-vertex-ai/ 或 /openai/）。AI Gateway 使用此路径识别提供商并应用正确的已存储凭据。
   • 统一 /compat/chat/completions 端点：确认你的 model 名称以提供商前缀开头（例如 google-vertex-ai/google/gemini-2.5-flash 或 openai/gpt-4o）。AI Gateway 使用此前缀路由请求并选择正确的已存储凭据。

3. 验证 BYOK 密钥选择：如果为某个提供商配置了多个密钥，请确保：

   • 你使用的是别名为 default 的密钥，或
   • 你包含了带有正确别名名称的 cf-aig-byok-alias 标头

4. 验证 BYOK 配置：如果使用 BYOK，请在仪表板中确认凭据已正确保存。

有关提供商特定的身份验证问题：

• Google Vertex AI 故障排除

有关 DLP 未触发或意外阻止等数据丢失防护问题的故障排除，请参阅 DLP 故障排除。

• 检查上游提供商是否遇到问题
• 考虑使用带回退的动态路由处理临时故障
• 审查你的速率限制配置

• 直接向提供商验证你的 API 密钥或凭据是否有效
• 检查提供商的状态页面是否有中断
• 查看 AI Gateway 日志 获取详细错误信息

• 验证 gateway 已启用缓存
• 检查请求方法和内容类型是否可缓存
• 流式响应默认不会被缓存

• 审查你的缓存 TTL 设置
• 检查是否有请求标头在绕过缓存或设置自定义缓存键。