快速结论:这个报错通常出现在 LiteLLM 代理转发 Groq 请求、且 Groq 返回 401(无效 API Key)或 404(错误 api_base)时。客户端拿到的 HTTP 状态码是对的,但 LiteLLM 内部抛出的异常类与 spend log 中的归一化错误被错标为 BadRequestError,因此优先排查 LiteLLM 版本,而不是 Groq 密钥本身(密钥无效时状态码本应是 401,这一点正常)。
适用环境:LiteLLM v1.108.9(Issue 中实测版本);Docker 部署方式(Issue 中通过 docker compose 启动代理);问题涉及 Groq 提供商(模型示例 groq/openai/gpt-oss-20b)。Issue 未提供操作系统、Python、CUDA、显卡信息。
最快修复方案:升级到 LiteLLM v1.109.0 或更高版本(该问题由 #32537 修复)。Issue 中评论者用假 Groq 复测:v1.108.9 为 BadRequestError,v1.109.1 的 401 变为 AuthenticationError、404 变为 NotFoundError。
注意事项:v1.108.9 属于旧 1.108 补丁线,不包含 #32537 的修复;仅在旧版本上调整密钥或 api_base 无法解决该错误分类问题。升级后建议用无效密钥和错误 api_base 各复测一次,确认异常类与 spend log 同步变化。
问题场景
用户在 LiteLLM 代理中配置 Groq 模型(litellm_params.model 为 groq/openai/gpt-oss-20b),然后将 GROQ_API_KEY 设置为无效值或使用缺少 /v1 的 api_base,并通过 /v1/chat/completions 发起请求(禁用 fallback)。代理返回的 HTTP 状态码为 401 或 404,但错误消息前缀、代理日志和 spend log 都把该错误归为 400 类错误。
报错原文
litellm.BadRequestError: GroqException - {"error":{"message":"Invalid API Key","type":"invalid_request_error","code":"invalid_api_key"}}
litellm.llms.custom_httpx.http_handler.MaskedHTTPStatusError: Client error '401 Unauthorized' for url 'https://api.groq.com/openai/v1/chat/completions'
File ".../litellm/litellm_core_utils/exception_mapping_utils.py", line 414, in _map_openai_exception
raise BadRequestError(
litellm.exceptions.BadRequestError: litellm.BadRequestError: GroqException - {"error":{"message":"Invalid API Key","type":"invalid_request_error","code":"invalid_api_key"}}
spend log: error_class: BadRequestError, error_code: 401, normalized_error: 400_INVALID_REQUEST
原因分析
Issue 报告的根因在 _map_openai_exception(litellm/litellm_core_utils/exception_mapping_utils.py)。该函数在检查 status_code 之前先做字符串匹配:只要错误体包含 invalid_request_error 且不包含 OpenAI 的措辞 “Incorrect API key provided”,就会抛 BadRequestError,从而无法进入 status_code == 401 的 AuthenticationError 分支。Groq 的 401 响应体恰好是 {“error”:{“message”:”Invalid API Key”,”type”:”invalid_request_error”,”code”:”invalid_api_key”}},因此被误判。同样,Groq 的 404 unknown_url(api_base 路径错误)也会被标为 BadRequestError。修复方向是让权威的 HTTP 状态码优先,同时不改变真正的 HTTP 400 invalid_request_error 处理逻辑。
环境排查
- 确认 LiteLLM 版本:v1.108.9 存在该问题;v1.109.0 及以上已修复。
- 确认部署方式为 Docker 代理,并由代理层实际转发到 Groq。
- 确认模型配置:model 为 groq/openai/gpt-oss-20b,api_key 来自 GROQ_API_KEY。
- 确认 spend log 中 error_class 与 normalized_error 字段的取值,用于判断是否命中该错误映射。
- 若使用自定义 api_base,确认路径是否包含 /v1(缺失会触发 Groq 404 unknown_url)。
解决步骤
- 查看当前 LiteLLM 版本,确认是否在 v1.109.0 以下(Issue 中问题版本为 v1.108.9)。
- 将 LiteLLM 升级到 v1.109.0 或更高版本,该版本包含 #32537 的修复。
- 重启 Docker 服务,使新版本生效。
- 用无效 GROQ_API_KEY 发送一次禁用 fallback 的 /v1/chat/completions 请求,观察异常类是否为 AuthenticationError。
- 用缺少 /v1 的 api_base 再请求一次,确认 404 被映射为 NotFoundError,而非 BadRequestError。
验证方法
按 Issue 中的复现步骤对假 Groq 或真实 Groq 重测:401 应返回 litellm.AuthenticationError(客户端仍为 401),spend log 中 error_class 应为 AuthenticationError;404 应返回 NotFoundError。评论者已在 v1.109.1 上验证为 AuthenticationError(401)与 NotFoundError(404)。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


![[Chore/Refactor] remove redundant-cast](https://www.chat-gpts.plus/wp-content/uploads/2026/11/24645-14ddc40c-768x403.jpg)