bug: client side error when rendering trace graph

用户在 Langfuse Cloud 平台中,查看某个包含大量复杂子 Span 的 Trace 详情页时触发。该 Trace 的 Span 结构复杂,导致客户端(浏览器)在渲染 Trace Graph 组件时抛出错误。用户 100% 可复现该问题。

bug: client side error when rendering trace graph

bug: client side error when rendering trace graph

快速结论:该报错发生在 Langfuse Cloud 中查看具有复杂 Span 结构的 Trace 时,浏览器控制台出现客户端渲染错误。优先检查是否已部署到 Langfuse v3.203.3 或更高版本,或者联系官方确认后端版本是否已包含修复。

问题场景

用户在 Langfuse Cloud 平台中,查看某个包含大量复杂子 Span 的 Trace 详情页时触发。该 Trace 的 Span 结构复杂,导致客户端(浏览器)在渲染 Trace Graph 组件时抛出错误。用户 100% 可复现该问题。

报错原文

console error: (截图显示客户端渲染错误) // 具体英文报错文本未在 Issue 中完整提供

注:Issue 中仅以截图形式展示报错,未提供完整的英文错误信息文本。根据 Issue 描述,该错误在浏览器控制台中可见,且与 #14733 可能有关联。

原因分析

该问题与 Trace Graph 前端组件的渲染逻辑有关。当 Trace 包含特别复杂或深层的 Span 结构时,客户端渲染引擎可能无法正确处理,导致抛出客户端侧错误。该问题已被确定为 UI Bug,并在 v3.203.3 版本中修复。

环境排查

  • Langfuse 版本:确认当前使用的 Langfuse 版本(尤其是 Cloud 用户需确认后端部署版本)。如果版本低于 v3.203.3,则可能受影响。
  • 浏览器及控制台:在浏览器开发者工具(Console)中查看完整的报错堆栈,有助于判断是否与特定前端依赖相关。

解决步骤

  1. 升级 Langfuse:将 Langfuse 后端升级到 v3.203.3 或更高版本。Cloud 用户可联系官方支持确认是否已部署该修复。
  2. 验证修复:升级后,重新访问之前报错的 Trace 页面,检查是否还出现客户端错误。
  3. 如果使用自定义部署:检查部署脚本或 Helm Chart 中的镜像标签,确保指向 v3.203.3 或更新的发布标签。

验证方法

在浏览器中打开之前报错的 Trace 页面,打开开发者工具控制台,确认没有渲染错误出现。同时确认 Trace Graph 可以完整、正常地展示所有 Span 结构。

参考来源

langfuse/langfuse #14732

celebrityanime
celebrityanime
文章: 11099

发表回复

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