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