快速结论:这个报错通常出现在 macOS 上通过 Homebrew 安装 llama.cpp 并运行 llama serve 或 llama-server 的场景:浏览器访问根路径 / 返回 404,因为该构建没有打包 Web UI。优先确认 Homebrew 安装的 llama.cpp 版本,并升级到已修复的版本。
适用环境:macOS;受影响模块为 llama-server;已确认触发问题的版本为 Homebrew llama.cpp 0.5.0;0.4.1 版本正常;0.6.0 版本已验证不再出现该问题。
最快修复方案:升级 Homebrew 的 llama.cpp 到 0.6.0 或更高版本,然后重新运行服务。
注意事项:该问题本身是构建产物缺 Web UI,并非用户配置错误。若仍停留在 0.5.0,仅改启动参数或端口通常无效。
问题场景
用户在 macOS 上通过 Homebrew 安装 llama.cpp 0.5.0,并运行 llama serve / llama-server。服务进程可以启动,但访问根路径 / 时无法加载 Web UI,而是返回 File Not Found 404。同一台机器上此前的 0.4.1 构建带有 Web UI,因此表现为升级后 UI 消失。
报错原文
Misc. bug: Homebrew's llama.cpp 0.5.0 has no web UI
llama serve answers / with a File Not Found 404
The Homebrew build of llama.cpp 0.5.0 ships without the web UI.
原因分析
最可能的原因是 Homebrew 的构建方式发生变化:Homebrew 现在在没有网络访问的环境中构建(Homebrew/homebrew-core#311973),导致构建过程无法下载 Web UI 所需资源。构建只打印警告后继续完成,最终产出的 0.5.0 包因此不包含 Web UI。Issue 中还提到,这可能是部分 Llama app 用户遇到的相关问题。
环境排查
- 确认操作系统:macOS。
- 确认 llama.cpp 来源:Homebrew。
- 确认 Homebrew llama.cpp 版本:0.5.0 会复现;0.4.1 正常;0.6.0 已修复。
- 确认受影响模块:llama-server。
- 确认访问路径:访问
/是否返回File Not Found404。 - 如需确认修复后的构建信息,可在升级后检查版本输出,例如 0.6.0 显示为 build 11429、commit d81235049。
解决步骤
- 先检查当前 Homebrew 安装的 llama.cpp 版本,确认是否仍为 0.5.0。
- 通过 Homebrew 升级 llama.cpp 到 0.6.0 或更高版本。
- 升级完成后重新启动
llama serve或 llama-server,避免旧进程继续占用端口。 - 在浏览器重新访问服务根路径
/,确认 Web UI 能正常加载。 - 如果仍返回 404,确认实际运行的可执行文件是否来自 Homebrew 新版本,而不是旧路径或旧进程残留。
验证方法
升级后再次运行 Homebrew 安装的 llama.cpp,并确认版本为 0.6.0 或更高;启动服务后访问根路径 /,若可正常显示 Web UI 而不再返回 File Not Found 404,即表示问题已解决。Issue 评论中已有人通过 brew install llama.cpp 进行全新安装,验证 0.6.0 不再出现该问题。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


