
issue: Refresh on frontpage empties selected model
快速结论:当用户在 Open WebUI 首页刷新页面或打开新标签页时,默认模型未被正确选中,下拉框为空。该问题通常出现在 v0.10.1 版本,与 `commit c584a4270` 引入的异步渲染顺序变更有关。优先排查是否为 v0.10.1,并升级到 v0.10.2 或更高版本。
问题场景
用户在 Open WebUI 前端(Frontpage)进行页面刷新(Refresh)或在新标签页中打开时,之前配置的默认模型(Default model)未被自动选中,导致模型选择下拉框显示为空。该问题在使用 OpenAI Responses API 时同样复现,浏览器控制台和 Docker 容器日志中均无错误输出。
报错原文
No error in browser console or Open WebUI container logs.
Symptom: After page refresh or on new tab, no model is selected in the frontpage dropdown.
原因分析
根据 Issue 讨论中的定位,该问题的根因是提交 c584a4270 将 setModels() 调用移出了 init 异步链(awaited init chain)。这导致 Chat.svelte 组件在 $models 尚未完全填充之前就提前渲染并执行了 initNewChat() 函数。由于模型列表此时为空,默认模型在过滤时被误判为无效模型而丢弃,最终表现为下拉框无模型被选中。该问题在 GitHub 上被多个用户复现确认。
环境排查
- Open WebUI 版本:确认是否为 v0.10.1,此版本存在该问题。
- Ollama 版本:无强制要求,但建议保持最新。
- 浏览器:已确认 Firefox 可复现,建议尝试 Chrome 或 Edge 交叉测试。
- 安装方式:Docker 部署,需确认是否使用了自定义环境变量或 Docker Compose 覆盖配置。
- API 后端:OpenAI Responses API 场景下同样触发,排查时不作为必要条件。
解决步骤
- 确认当前 Open WebUI 版本是否为 v0.10.1,可通过 WebUI 设置页面或 Docker 容器日志查看版本信息。
- 可优先尝试:将 Open WebUI 升级到
v0.10.2或更高版本。根据 Issue 确认,v0.10.2 版本已修复此问题。 - 如果升级后问题依旧存在,请清理浏览器缓存(包括 Service Worker 和 LocalStorage),然后重新登录测试。
- 若仍无法解决,请检查 Docker 部署中是否使用了与默认模型相关的环境变量(如
DEFAULT_MODELS或ENABLE_MODEL_FILTER),尝试移除后重启容器再测试。
验证方法
完成升级后,执行以下步骤确认问题已修复:
- 在 Open WebUI 设置中配置一个默认模型。
- 刷新首页(F5 或浏览器刷新按钮),观察模型下拉框是否自动选中之前配置的默认模型。
- 在新标签页中打开 Open WebUI,确认模型选择器同样显示正确默认模型,而非空。
如果上述操作后默认模型正常加载,则问题已解决。



