bug: “(0, d.createOpenAI) is not a function” when creating a new LLM connection (v3.225.4)

快速结论：该报错发生在自托管 Langfuse 的 LLM Connections 创建连接时，优先排查是否使用了 DockerHub 的第三方“加固镜像”（DHI hardened images）。此问题在官方镜像或降级到 v3.225.0 后即可解决。

适用环境：已确认受影响环境为 Langfuse v3.225.4 OSS 自托管，且使用 DockerHub 上的 DHI 加固镜像（langfuse/langfuse 和 langfuse/langfuse-worker 的 debian-13 版本）。官方维护者明确表示 DHI 镜像并非官方提供，不在支持范围内。

最快修复方案：Issue 中唯一的已验证修复方案是：降级到 v3.225.0，并改用非加固（非 DHI）镜像；或者直接改为运行官方镜像 langfuse/langfuse。若官方已发布 v4，也可先升级测试。

注意事项：上述方案来自 Issue 讨论链中的用户反馈，并非官方验证的修复路径；官方镜像（https://hub.docker.com/r/langfuse/langfuse/tags）不受此问题影响。

问题场景

用户在使用自托管的 Langfuse v3.225.4（OSS 版本）时，进入 Project Settings → LLM Connections，点击“Add LLM Connection”，选择 OpenAI 适配器并填写名称与 Token 后，点击“Create connection”立即报错，连接无法创建，导致 Playground 无法使用。该问题在浏览器缓存清理后与无痕模式下仍然存在。

报错原文

bug: "(0, d.createOpenAI) is not a function" when creating a new LLM connection (v3.225.4)

(0 , d.createOpenAI) is not a function

原因分析

可能与模块解析或打包（bundling）有关。报错中的 createOpenAI 指向 @ai-sdk/openai 的工厂函数，说明运行时无法正确解析或加载该模块。由于报错不涉及 Provider、API Key 或 Base URL，可排除连接配置问题。在排除缓存因素后，最可能的原因是使用的 Docker 镜像为第三方“加固（hardened）”版本，其打包方式或依赖裁剪破坏了 @ai-sdk/openai 的引入方式。请优先检查当前部署使用的镜像来源。

环境排查

确认 Langfuse 版本是否为 v3.225.x（特别是 v3.225.4）。
确认部署使用的 Docker 镜像是否来自 DockerHub 的 DHI 加固镜像目录（如 dhi/langfuse 或 dhi/langfuse-worker 的 debian-13 镜像）。
确认是否误用了第三方构建的镜像而非官方 langfuse/langfuse。
检查浏览器端是否有旧版缓存（Issue 中已排除，但建议再次确认）。

解决步骤

首先检查当前生产环境的镜像来源：在部署服务器执行 docker ps 查看实际使用的镜像名称与标签。
若确认为 DHI 加固镜像，请直接更换为官方镜像 langfuse/langfuse 及对应的 worker 镜像（参考官方 Docker Hub）。这是可优先尝试的修复方案。
若因某些原因暂时无法更换镜像，可作为临时方案将版本降级到 v3.225.0（该版本在非加固镜像下已验证正常）。
如果当前版本低于 v3.225.0，也可先升级到 v3.225.0 验证问题是否消失（Issue 中用户反馈升级到 3.225.4 后问题依然存在）。
清理浏览器缓存并使用无痕窗口重新测试；若更换镜像后问题依然存在，再考虑检查网络防火墙或代理是否拦截了 @ai-sdk/openai 相关的静态资源请求。