
Misc. bug:
快速结论:该报错通常发生在 llama-server 内置 PWA(渐进式 Web 应用)界面完全无法正常渲染时,表现为页面布局错乱、空白或样式问题。优先排查最近的 commit 是否引入了静态资源加载或路由变化,并尝试回退到旧版本(如 b9704)确认。
问题场景
用户在使用 llama-server 启动模型服务后,通过浏览器访问内置的 WebUI(PWA)界面时,界面完全损坏(fully broken),无法正常显示和操作。该问题在浏览器端复现(Firefox 和 Chromium 均受影响),且与 llama-server 版本有关。
报错原文
GUI(PWA) is fully broken, here is a photo
The built-in Web UI is broken for me as well. Reproduced in both Firefox and Chromium.
原因分析
可能原因:在最近 3 天的 commit 中(从 b9704 到 b9724),某次提交修改了内置 WebUI 的静态资源(如 HTML、CSS、JavaScript 文件)的路由或打包方式,导致浏览器无法正确加载或解析页面资源。该问题与模型文件、服务器参数(-c、-ngl 等)无关,仅与 llama-server 的 WebUI 前端代码变更有关。
环境排查
- llama-server 版本:确认当前版本号(如 b9724,commit e2e7a9b2d04e0404131e551243d4bd399ccfe606)
- 浏览器类型:Firefox、Chromium 或其他 Blink 内核浏览器
- 操作系统:Linux(Arch Linux 或其他发行版)
解决步骤
- 回退版本:将 llama-server 从 b9724 降级至 b9704(即提交 3 天前的版本),并重新测试 WebUI。
- 确认回退后问题消失:使用相同命令行参数(如上文中的
-m、-c、-ngl等)启动旧版本 llama-server,验证 WebUI 是否正常加载。 - 检查更新上游修复:追踪 Issue #24879(已提交修复 PR),拉取包含修正的最新代码,或等待下一个发布版本。
- 临时替代方案:如果无法升级,可在旧版本中使用;或尝试通过 REST API 直接调用(如使用 curl 或其他客户端)绕过 WebUI。
验证方法
启动 llama-server 后,在浏览器中访问 http://localhost:8080(或指定端口),查看页面是否正常渲染。如果页面显示正常、布局完整、交互可用,则问题已解决。



