问题梳理总结
AI 解答:被他带偏两天两夜,各种尝试。连服务器都重装了。就差点重新改写openweui的源码自己编译了。最后换个浏览器解决。

现象
银河麒麟V10(ARM64)部署 OpenWebUI v0.10.2 / v0.11.2
- 新建知识库:列表偶尔显示文件计数数字,但无法进入知识库详情;刷新后知识库条目直接消失。
- 后端数据库、Chroma向量库、容器权限、数据库迁移均无异常,问题根源不在服务端。
- ✅ 根因定位:银河麒麟自带浏览器内核版本老旧,前端JS渲染/接口解析存在兼容性bug,不是OpenWebUI后端故障。
原因简述
麒麟自带浏览器基于老旧内核,对OpenWebUI新版前端的API响应解析、前端状态管理、列表组件渲染存在兼容性缺陷:
- 后端已经成功创建知识库元数据(所以能看到文件数量);
- 老旧内核前端拿到接口数据后,前端状态渲染异常:页面不渲染知识库卡片详情,刷新时前端状态丢失,表现为知识库消失;
- 切换新版Chrome浏览器访问,现代内核正常解析前端逻辑,知识库创建、列表查看、进入详情全部正常。
区分重点:
- 后端问题:换任何浏览器现象都一致,日志会报sql/chroma/permission报错;
- 前端浏览器内核问题:后端无报错,更换现代浏览器立刻恢复,你的场景属于这一类。
解决方案(最简方案优先)
方案1(已验证可用,推荐)
在银河麒麟ARM64系统安装新版Chrome/Chromium,使用新版浏览器访问OpenWebUI。
- 优点:改动最小,服务端完全不用调整,直接解决知识库消失、点不进去的问题;
- 适用:用户访问OpenWebUI的终端环境。
bash
wget https://dl.google.com/linux/direct/google-chrome-stable_current_arm64.deb
sudo dpkg -i google-chrome-stable_current_arm64.deb
# 缺依赖就执行:sudo apt -f install
方案2(备选,不推荐优先使用)
- 升级麒麟自带浏览器内核(银河麒麟自带浏览器内核升级受限,难度高,兼容性风险不可控);
- 前端侧降级OpenWebUI版本适配老内核(会丢失新功能,还可能引入后端知识库迁移bug,得不偿失)。
运维注意事项
- 排查时先区分后端问题 vs 浏览器前端兼容问题:更换浏览器快速验证,是最简单的定位手段;
- 给使用OpenWebUI的用户做访问规范:禁止使用麒麟系统内置老旧浏览器,统一使用新版Chrome/高版本Chromium;
- 若后续出现同类页面异常(对话加载异常、文件上传失败、UI错乱),优先排查客户端浏览器内核,不要优先去动容器、数据库、向量库;
- 之前排查的权限、sqlite、chroma问题,属于同类现象的另一大类原因,本次场景可以排除。
故障判定口诀
换浏览器就好,问题在前端内核;
所有浏览器都坏,排查后端服务。
如果你需要,我可以整理一段简短的故障说明文档,直接放到运维手册里。