bug: LANGFUSE_S3_CONCURRENT_WRITES and LANGFUSE_S3_CONCURRENT_READS not applied as expected

问题场景

用户在自托管 Langfuse 环境中，向实例发送大量 traces/spans 时触发该问题。用户已经在环境变量中设置了较高的 LANGFUSE_S3_CONCURRENT_WRITES 和 LANGFUSE_S3_CONCURRENT_READS，但 pod 日志中仍持续出现 @smithy/node-http-handler 的 socket acquisition 警告。用户怀疑这些环境变量没有被 S3 客户端正确读取。

报错原文

bug: LANGFUSE_S3_CONCURRENT_WRITES and LANGFUSE_S3_CONCURRENT_READS not applied as expected

... @smithy/node-http-handler warnings ...

原因分析

根据 Issue 讨论中的分析：

• LANGFUSE_S3_CONCURRENT_WRITES 确实会从环境变量中加载，并用于为 S3 客户端设置 maxSockets，因此在代码层面调高该值应增加允许的并发 S3 连接数。
• LANGFUSE_S3_CONCURRENT_READS 似乎没有被用于 S3 客户端配置，所以单独调高它对读操作没有效果，除非代码更新以将该变量应用于读操作。
• 如果已经在 LANGFUSE_S3_CONCURRENT_WRITES 设置很高的情况下仍看到 socket acquisition 警告，可能原因包括：环境变量未在容器中设置或未正确传播；部署配置中存在拼写错误或覆盖；或者与使用的 AWS SDK 版本不兼容。

环境排查

• 确认 Langfuse 版本：Issue 中为 3.97.2。
• 确认 LANGFUSE_S3_CONCURRENT_WRITES 是否在运行中的容器内实际生效，可在容器内执行 env 查看，或在 S3 客户端构造处打印该值。
• 检查部署配置中是否存在拼写错误或对同名环境变量的覆盖。
• 确认当前使用的 AWS SDK 版本是否支持 maxSockets 选项。
• 确认 LANGFUSE_S3_CONCURRENT_READS 在当前版本中是否已被应用于 S3 客户端配置（根据讨论，尚未应用）。

解决步骤

1. 进入运行中的 Langfuse 容器，执行 env 或等效命令，确认 LANGFUSE_S3_CONCURRENT_WRITES 的实际值是否符合预期。
2. 检查部署文件（如 Docker Compose、Kubernetes manifest、Helm values 等）中该环境变量的拼写，确认没有被其他配置覆盖。
3. 在 S3 客户端构造处增加日志，打印实际传入的 maxSockets 值，确认运行时真正使用的值。
4. 如果确认 LANGFUSE_S3_CONCURRENT_WRITES 已正确传入且 SDK 兼容，但警告仍存在，可关注后续版本是否更新了 LANGFUSE_S3_CONCURRENT_READS 的应用逻辑。
5. 如果排查后仍无法解决，建议在 Issue 中补充运行时环境与 SDK 版本的详细信息以便进一步分析。

验证方法

在调整环境变量并确认其在容器内生效后，重新向 Langfuse 发送较大量的 traces/spans，观察 pod 日志中 @smithy/node-http-handler 的 socket acquisition 警告是否减少或消失。同时确认 S3 客户端构造时打印的 maxSockets 值与预期一致。

参考来源

langfuse/langfuse #8530

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。