issue: Provider returned error
快速结论：该报错在 Open WebUI v0.10.0+ 版本中，使用 OpenRouter 作为后端且调用部分 GPT 系列自定义模型（如 gpt-5.3-chat、gpt-5.4）时触发。优先排查自定义模型是否启用了工具调用（Tool Calling/Function Calling），以及 OpenRouter 返回的实际错误信息是否被 Open WebUI 日志过滤。
问题场景
用户在 Docker 部署的 Open WebUI v0.10.2（基于 Debian 13）中，配置了 OpenRouter 作为模型提供方。创建了多个基于 gpt-5.4 或 gpt-5.3-chat 的自定义模型。部分自定义模型在聊天时抛出错误，而部分自定义模型（基于 glm 系列）正常工作。用户已启用容器调试日志，但日志未输出来自 OpenRouter 的原始错误信息。
报错原文
open_webui.main:process_chat:1504 - Error processing chat payload: Provider returned error原因分析
Issue 讨论中并未定位到单一根因，根据用户描述和相关 Issue（#26652、#20415、#22603）推断，可能原因如下：
- 自定义模型配置问题：部分 GPT 自定义模型（可能是模型设置或提示词）导致了 OpenRouter 返回错误，但 Open WebUI 未将 OpenRouter 的原始错误信息传递到日志中。
- 工具调用（Tool Calling）功能变更：v0.10.0 对工具调用逻辑进行了改动。某些 GPT 模型虽然原生支持工具调用，但在新版本 Open WebUI 中，模型设置或工具调用处理可能触发 OpenRouter 拒绝请求。
- OpenRouter 端对特定模型的可用性变化：用户使用的 gpt-5.3-chat / gpt-5.4 等模型可能在 OpenRouter 上存在临时性限制或参数变更。
注意：Issue 创建人明确指出无法提供确切复现步骤，且部分 GPT 自定义模型工作而部分不工作，说明此问题可能与具体模型设定（如 Temperature、Max Tokens 等参数）或提示词格式相关。
环境排查
- Open WebUI 版本：v0.10.2（或 v0.10.0+）
- 部署方式：Docker
- 后端模型提供方：OpenRouter
- 受影响模型：gpt-5.4、gpt-5.3-chat 等部分 GPT 系列自定义模型
- 未受影响模型：glm 系列自定义模型
- Ollama 版本：未使用
解决步骤
- 确认日志是否可透传 OpenRouter 错误：启用 Open WebUI 容器日志（DEBUG 模式），检查
docker logs <container_name>输出。如果日志仅显示Provider returned error而无其他内容，说明错误被上层捕获，应尝试直接通过 API 测试 OpenRouter 调用。 - 使用 curl 或 Postman 直接测试 OpenRouter API：以相同的自定义模型设置（包括 system prompt 和用户输入）调用 OpenRouter API，查看是否返回详细错误信息（如 400 Bad Request）。
- 检查并关闭工具调用：在自定义模型设置中，确认是否启用了“工具调用”或“Function Calling”。如果启用，尝试关闭后再测试问题是否复现（可优先尝试）。
- 对比正常/异常自定义模型的配置差异：分别导出正常工作与报错的自定义模型设置（JSON），对比 Temperature、Top P、Max Tokens、Stop Sequences、Tools 等参数是否存在差异。
- 降级或升级版本验证：如果步骤有效但无法定位参数，可尝试降级 Open WebUI 至 v0.9.x 确认是否为 v0.10.0 引入的回归问题，或升级至包含潜在修复的最新版本（如 v0.10.3 以上）。
- 参考相关 Issue 中的处理方法：Issue 列表中的 #26652 用户报告了类似问题（gpt-5.5 在 v0.10.x 中抛出 “The request was invalid”），建议检查 OpenRouter 端是否对请求体有格式要求变更（如工具调用参数格式）。
验证方法
执行上述步骤后，尝试在正常使用条件下（使用与报错相同的自定义模型和提示词）发起聊天，确认不再弹出 Provider returned error 错误。如果问题依然存在，建议在 OpenRouter 控制台查看 API 调用记录，获取具体错误码。
参考来源
open-webui/open-webui #26692
相关 Issue：
#26652 issue: model gpt-5.5 throws “The request was invalid” on all chats
#22603 issue: Provider returned error
#20415 Native Function Calling fails with multiple tools having long descriptions (Gemini 3 via OpenRouter)
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
