bug: Application error: a client-side exception has occurred

用户在使用 Langfuse Cloud(SaaS 版本)时,进入 Observability → Tracing 并点击任意 trace 条目,页面触发客户端渲染异常,并显示此错误。问题影响最新版 Firefox 和 Chromium 浏览器。

bug: Application error: a client-side exception has occurred

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 发布)

解决步骤

  1. 优先尝试:强制刷新浏览器(例如 Windows/Linux 按 Ctrl+F5,Mac 按 Cmd+Shift+R);部分用户反馈仅需刷新页面即可恢复,无需清除浏览器缓存。
  2. 如果刷新无效,等待几分钟后刷新,Langfuse Cloud 会自动部署修复版本 v3.203.3,更新后问题自动消失。
  3. 无需手动安装或升级——此问题仅影响 Langfuse Cloud,不涉及自托管环境。

验证方法

重新进入 Observability → Tracing 页面,点击任意 trace,查看其详情面板是否正常渲染且不再弹出 “Application error” 提示。或者直接检查页面是否正常加载而不崩溃。

参考来源

langfuse/langfuse #14733

celebrityanime
celebrityanime
文章: 11099

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注