Skip to content

Open WebUI 常见报错处理

页面能打开,但模型请求失败

检查管理员后台的 Connections:

  • Base URL 是否为 https://xikapi.com/v1
  • API Key 是否正确。
  • 当前用户是否有权限使用该模型。

401 Unauthorized

通常是 API Key 错误或环境变量没有被容器读取。

处理方式:

bash
docker inspect open-webui

确认容器环境变量中存在 OPENAI_API_KEY。如果通过后台配置,则重新保存连接。

404 Not Found

Base URL 不要写具体接口路径。

正确:

text
https://xikapi.com/v1

错误:

text
https://xikapi.com/v1/chat/completions

新模型不显示

处理方式:

  • 在管理员后台手动添加模型。
  • 保存 Connections 后刷新页面。
  • 确认用户权限允许看到该模型。

容器更新后配置丢失

通常是没有挂载数据卷。部署时需要保留:

text
/app/backend/data

建议使用命名 volume:

text
open-webui:/app/backend/data