
bug: Application error: a client-side exception has occurred
快速结论:该报错在 Langfuse Cloud 的 Tracing 页面点击任意 trace 时触发,原因为 SWC 生产构建压缩错误导致代码被错误删除。优先尝试强制刷新浏览器(无需清除缓存),或等待 Langfuse Cloud 自动更新至 v3.203.3 以上版本。
问题场景
用户在使用 Langfuse Cloud(SaaS 版本)时,进入 Observability → Tracing 并点击任意 trace 条目,页面触发客户端渲染异常,并显示此错误。问题影响最新版 Firefox 和 Chromium 浏览器。
报错原文
Application error: a client-side exception has occurred
(see the browser console for more information)
原因分析
已确认原因:这是 Langfuse 生产构建阶段的一个 SWC 压缩 bug。原本可正常运行的 JavaScript 代码,在生产构建(prod build)中被错误地压缩删除(”dead code elimination”),导致客户端渲染时抛出异常。该问题只在生产环境构建中出现,开发环境不受影响。
环境排查
- 使用环境:Langfuse Cloud(非自托管)
- 浏览器:最新版 Firefox 或 Chromium
- 受影响功能:Observability → Tracing → 点击任意 trace
- Langfuse 修复版本:v3.203.3(2026-07-02 发布)
解决步骤
- 优先尝试:强制刷新浏览器(例如 Windows/Linux 按
Ctrl+F5,Mac 按Cmd+Shift+R);部分用户反馈仅需刷新页面即可恢复,无需清除浏览器缓存。 - 如果刷新无效,等待几分钟后刷新,Langfuse Cloud 会自动部署修复版本 v3.203.3,更新后问题自动消失。
- 无需手动安装或升级——此问题仅影响 Langfuse Cloud,不涉及自托管环境。
验证方法
重新进入 Observability → Tracing 页面,点击任意 trace,查看其详情面板是否正常渲染且不再弹出 “Application error” 提示。或者直接检查页面是否正常加载而不崩溃。


