用途：面向已安装 Langfuse SDK 并配置 API 凭据的开发者，用于诊断和修复 Langfuse 集成中的常见错误与异常，帮助排查追踪缺失和集成问题。
主要能力：整理 10 类常见错误的真实报错、根因与已验证的解决方案，包括 401 认证失败、追踪未出现在面板、网络/连接错误、Token 用量缺失、Span 长期处于进行中、重复追踪、SDK 导入错误、环境变量未加载、自托管连接问题以及 429 限流。另附快速诊断脚本，检查 Node/Python 版本、已安装 SDK、配置项与连通性。
使用方式：先复制失败环境中的确切错误、SDK 版本与 Langfuse base URL，匹配错误参考并应用最小修复；运行诊断脚本时不要打印密钥值；确认目标项目出现一条追踪或评分后再恢复生产流量。若问题持续，收集调试包并按升级路径处理。
限制：涉及更改凭据、端点、SDK 主版本或保留设置的修复，需在诊断后由操作者批准；报告中不得包含 API 密钥、授权头或原始客户提示词。具体版本兼容与平台细节以官方资料为准，本资料未提供收费与价格信息。