快速结论:在 Open WebUI 开发版中,从文件夹自己的页面修改文件夹图标后,图标会立即保存并显示在该页面和文件夹标签上,但侧边栏中的文件夹行要刷新页面后才更新。这属于文件夹页面与侧边栏之间的状态同步回归,优先排查文件夹页在保存图标后是否触发侧边栏数据更新。
适用环境:Open WebUI 开发版(dev);Issue 确认出现问题的提交为 4acf39ec2,正常版本为 3bfc168d6,问题由文件夹页面重构提交 06491f013 引入。Issue 未提供操作系统、Python、CUDA、显卡或依赖版本信息。
最快修复方案:暂无确认的一步修复方案。Issue 中未给出已验证的修复提交或临时规避方法。
注意事项:刷新页面后图标能正常显示,说明图标已经持久化存储,问题只影响侧边栏的即时刷新。若通过回退或替换版本规避,建议先确认目标版本不包含文件夹页面重构,并注意测试仓库的 e2e 用例可能依赖具体提交。
问题场景
用户在使用 Open WebUI 的文件夹功能时,先从侧边栏创建一个文件夹并打开其文件夹页面,同时保持侧边栏的 Folders 区域展开。之后在文件夹页面点击“Change folder icon”并选择任意 emoji 图标,预期侧边栏中该文件夹行立即显示新图标,但实际侧边栏仍显示默认文件夹图标,约 10 秒后仍未更新,只有重新加载页面后才显示新图标。该问题在浏览器端 e2e 测试 e2e/chat/test_folder_projects.py::test_a_folders_icon_and_background_image_show_and_are_stored 中被捕获。
报错原文
issue: [regression] [dev] a folder icon picked on the folder page does not show in the sidebar until a reload
The sidebar row still shows the plain folder 10 seconds later. The icon only appears after a reload, so it was stored.
原因分析
可能原因:文件夹页面在保存图标后更新了文件夹页面自身及其标签页状态,但没有同步更新侧边栏所依赖的文件夹列表状态;侧边栏在重新挂载或重新加载数据前,仍使用旧的文件夹数据。Issue 指出问题由文件夹页面重构提交 06491f013 引入,且已有相关 Issue #28690 报告过同一底层问题:从文件夹页面重命名文件夹、修改图标或创建子文件夹时,侧边栏不会更新。
环境排查
- 确认 Open WebUI 版本或提交号:问题提交为
4acf39ec2,正常提交为3bfc168d6,疑似引入提交为06491f013。 - 确认部署方式是否为 dev 构建,以及是否包含文件夹页面重构相关代码。
- 在浏览器中保持侧边栏 Folders 区域展开,以便观察修改文件夹图标后的即时状态。
- Issue 未提供 Python、CUDA、PyTorch、显卡及节点版本,这些环境项无需作为本次问题的首要排查方向。
解决步骤
- 先复现问题:创建文件夹并打开文件夹页面,保持侧边栏展开,在文件夹页面修改图标,观察侧边栏是否立即更新。
- 刷新页面,确认侧边栏是否显示新图标。如果刷新后显示,说明图标已保存,问题属于侧边栏状态未同步。
- 对照提交号:若当前为
4acf39ec2,可确认处于问题版本;3bfc168d6下该行为正常。 - 检查
06491f013中文件夹页面保存图标后的状态更新逻辑,以及侧边栏文件夹列表的数据来源,确认保存后是否触发侧边栏重新获取或更新文件夹数据。 - 可优先尝试的一种处理方向:在保存文件夹图标成功后,同步刷新或更新侧边栏使用的文件夹列表状态。该方向基于问题现象推断,Issue 中未给出已验证的代码修复。
- 如短期内无法修复,可先接受刷新页面作为临时规避手段,但这不解决回归问题本身。
验证方法
在文件夹页面修改图标后,不刷新页面,直接观察侧边栏中该文件夹行是否立即显示新图标;同时可运行或关注 e2e 用例 test_a_folders_icon_and_background_image_show_and_are_stored,确认其通过。还可对比 3bfc168d6 与修复后的版本,验证侧边栏即时更新行为一致。
参考来源
相关 Issue:open-webui/open-webui #28690
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


