快速结论:当同一 langfuse/langfuse 镜像标签的 amd64 与 arm64 变体带有不同的 Next.js build ID,而 Web 副本又混合跑在两种架构节点上、负载均衡未开启会话粘性时,浏览器会向 build ID 不匹配的副本请求静态资源并收到 404,页面卡在“Loading”。优先比对两个平台镜像内的 /app/web/.next/BUILD_ID,并固定 Web 部署架构或开启会话粘性。
适用环境:自托管 Langfuse 4.72.0(Helm chart langfuse-k8s 2.1.7,Next.js 16.4.2),同样存在于 3.225.5(Next.js 16.2.11);Kubernetes 混合 amd64/arm64 节点,Web 副本经无粘性的负载均衡(如 AWS ALB,target type ip)对外。仅影响 Web UI,API 数据摄入不受影响。
最快修复方案:暂无确认的一步修复方案。Issue 中的“Possible fix”仅为建议,未在发布流程中验证。自托管者可优先尝试将 Web 部署固定到单一架构,例如设置 langfuse.web.pod.nodeSelector: {kubernetes.io/arch: arm64};或为负载均衡开启会话粘性。
注意事项:会话粘性只是缩小问题范围:粘住的副本下线后仍会复现。固定架构时要注意,chart 中按组件设置的 nodeSelector 会替换全局 nodeSelector,需把全局键一并重复写入。此外,评论指出仅统一 build ID 可能不足以解决全部资源不兼容,还需验证跨副本的 webpack chunk 请求。
问题场景
用户在 Kubernetes 集群中自托管 Langfuse Web 服务,节点同时包含 amd64 与 arm64,同一 langfuse/langfuse 标签的多副本分布在两种架构上,前置负载均衡不做会话粘性。用户通过浏览器打开 UI 时页面一直停在“Loading”,DevTools 中可见 /_next/static/<buildId>/… 与 /_next/data/<buildId>/… 返回 404。Issue 中通过 headless Chrome 捕获到:
404 /_next/static/23TW8Su9EW8gfqiPEctHA/_clientMiddlewareManifest.js
final page: "/" → "Loading ..." (never reaches /auth/sign-in)
报错原文
bug: amd64 and arm64 images of the same tag have different Next.js build IDs; multi-arch web replicas 404 on /_next/static and hang on "Loading"
404 /_next/static/23TW8Su9EW8gfqiPEctHA/_clientMiddlewareManifest.js
final page: "/" → "Loading ..."
原因分析
最可能的原因是:web/next.config.mjs 未设置 generateBuildId 与 deploymentId,因此每个平台的 next build 各自生成随机 build ID。Issue 中给出的 langfuse/langfuse:4.72.0 实测数据如下:
- linux/amd64(manifest digest
sha256:18d288adb5d736127d1d04c05ea8c2148365ffd3e6c31f3945d0e149b3f7c143):BUILD_ID 为FWNfh-BASE7d4u3CME44n - linux/arm64(manifest digest
sha256:d0680bca1238aa6feac4cfc60460c8bb6568aed5f52b9562756fb6782fe08680):BUILD_ID 为23TW8Su9EW8gfqiPEctHA
该文件被烘焙进镜像(mtime Oct 29 16:27),运行时不会改变。3.225.5 同样如此:amd64 为 k57ij1hYQVkS8FabwRqoc,arm64 为 zeE0bD_Wz-uCmjtUCLJfs。当所有副本都在同一架构时,每个 /_next/static 请求返回 200,页面能到达 /auth/sign-in。
评论补充了一个可能与修复相关的细节:发布工作流向两个平台的构建传入 BUILD_ID=${{ github.sha }},但 web Dockerfile 的 builder 阶段接收的是 NEXT_PUBLIC_BUILD_ID,并非 BUILD_ID;运行时 BUILD_ID 是在 runner 阶段、turbo run build 完成之后才赋值。因此仅在 generateBuildId 里读取 process.env.BUILD_ID 并不能在编译期拿到该值,还需把 SHA 以对应名称传入 builder 阶段,或改为消费工作流显式传入的 NEXT_PUBLIC_BUILD_ID。
环境排查
- 确认自托管 Langfuse 版本(Issue 中为 4.72.0 与 3.225.5)及 Helm chart 版本(langfuse-k8s 2.1.7)。
- 确认镜像标签同时包含 linux/amd64 与 linux/arm64 变体。
- 确认 Web 副本所在的 Kubernetes 节点架构分布;使用 Karpenter 或混合架构 spot 池时容易混布。
- 确认负载均衡是否开启会话粘性(Issue 中为 AWS ALB、target type
ip,未开启)。 - 确认
web/next.config.mjs是否配置了generateBuildId/deploymentId。 - 确认发布工作流与 web Dockerfile 中 build arg 的名称是否对应(
BUILD_ID与NEXT_PUBLIC_BUILD_ID)。
解决步骤
- 比对两个平台镜像的 build ID(Issue 中给出的复现命令):
docker run --rm --platform linux/amd64 --entrypoint cat langfuse/langfuse:4.72.0 /app/web/.next/BUILD_ID
docker run --rm --platform linux/arm64 --entrypoint cat langfuse/langfuse:4.72.0 /app/web/.next/BUILD_ID
若输出不同,即确认存在 build ID 不一致。 - 自托管者可优先尝试:将 Web 部署固定到单一架构,例如设置
langfuse.web.pod.nodeSelector: {kubernetes.io/arch: arm64}。若存在全局nodeSelector,需把其中的键重复写入组件级配置,因为组件级选择器会替换全局选择器。 - 或可优先尝试:在负载均衡上开启会话粘性,使同一浏览器会话持续落到同一副本。
- 关注上游修复:若采用给两个平台构建指定相同 build ID 的方案,需同时把 commit SHA 在 builder 阶段以 Dockerfile 实际接收的 build arg 名称传入,否则编译期无法取得该值。
验证方法
让至少一个 amd64 副本和一个 arm64 副本同时对外提供服务,打开 UI:开启会话粘性或固定架构后页面应能到达 /auth/sign-in,DevTools 中 /_next/static 请求不再出现 404。若上游修复了 build ID,应进一步检查跨副本的 webpack chunk 请求(不仅是 BUILD_ID 文件本身是否一致),以确认资源不兼容问题是否完全消除。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


