【信创】 OpenWebUI v0.10.2 / v0.11.2 新建知识库莫名消失,刷新只显示数字-不见知识库列表解决办法

问题梳理总结

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

现象

银河麒麟V10(ARM64)部署 OpenWebUI v0.10.2 / v0.11.2

  • 新建知识库:列表偶尔显示文件计数数字,但无法进入知识库详情;刷新后知识库条目直接消失。
  • 后端数据库、Chroma向量库、容器权限、数据库迁移均无异常,问题根源不在服务端。
  • ✅ 根因定位:银河麒麟自带浏览器内核版本老旧,前端JS渲染/接口解析存在兼容性bug,不是OpenWebUI后端故障。

原因简述

麒麟自带浏览器基于老旧内核,对OpenWebUI新版前端的API响应解析、前端状态管理、列表组件渲染存在兼容性缺陷:

  1. 后端已经成功创建知识库元数据(所以能看到文件数量);
  2. 老旧内核前端拿到接口数据后,前端状态渲染异常:页面不渲染知识库卡片详情,刷新时前端状态丢失,表现为知识库消失;
  3. 切换新版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(备选,不推荐优先使用)

  1. 升级麒麟自带浏览器内核(银河麒麟自带浏览器内核升级受限,难度高,兼容性风险不可控);
  2. 前端侧降级OpenWebUI版本适配老内核(会丢失新功能,还可能引入后端知识库迁移bug,得不偿失)。

运维注意事项

  1. 排查时先区分后端问题 vs 浏览器前端兼容问题:更换浏览器快速验证,是最简单的定位手段;
  2. 给使用OpenWebUI的用户做访问规范:禁止使用麒麟系统内置老旧浏览器,统一使用新版Chrome/高版本Chromium;
  3. 若后续出现同类页面异常(对话加载异常、文件上传失败、UI错乱),优先排查客户端浏览器内核,不要优先去动容器、数据库、向量库;
  4. 之前排查的权限、sqlite、chroma问题,属于同类现象的另一大类原因,本次场景可以排除。

故障判定口诀

换浏览器就好,问题在前端内核;

所有浏览器都坏,排查后端服务。

如果你需要,我可以整理一段简短的故障说明文档,直接放到运维手册里。

相关推荐
super_Omni3 小时前
text/PDF/Word → 解析成纯文本 → 分词 → 词表匹配 → 加权打分 → 低于阈值
前端·chrome
asaotomo1 天前
截图识题、AI 讲解、笔记沉淀:Chrome 扩展体验
前端·chrome·笔记
SEO_juper1 天前
Chrome 扩展一键查看当前页面 SEO 信息:不用切页面,点一下全出来
前端·javascript·chrome
web打印社区2 天前
Chrome-kiosk-printing能上生产吗
开发语言·前端·javascript·chrome·websocket
夜雪一千2 天前
Linux 管道、重定向命令介绍
linux·运维·chrome
yz_aiks2 天前
chrome-use 使用教程:让 Claude Code 操控已登录的 Chrome(禅道、ONES 实测)
chrome·自动化·大模型·ai agent
super_Omni2 天前
Chrome 插件入驻实战:从 Manifest V3 到过审上架的完整路径
大数据·前端·chrome
TDengine (老段)3 天前
TDengine IDMP 十大实用功能(2)
大数据·数据库·chrome·时序数据库·tdengine·idmp·有问有答
Zenova EdgeOS3 天前
Linux 日志实战:用 journalctl 精准检索与治理工业边缘日志
linux·运维·chrome
甜到心里的蛋糕3 天前
抖音评论自动回复机器人部署实践:无头 Chrome + DeepSeek + NapCat(2C2G 云主机)
java·jvm·chrome·python·抖音·deepseek