issue: prepare-pyodide.js can leave static/pyodide/ in a broken, non-functional half-state if interrupted mid-build

问题场景

用户在构建 Open WebUI 时，static/pyodide/ 目录处于“半成品”状态：目录中存在 pyodide-lock.json 文件，但缺少 Pyodide 运行时文件，导致浏览器中 Pyodide 相关功能（如代码执行、文件浏览）无法正常使用。报告者最初怀疑是构建中断导致文件未写完，但实际排查后确认是自己的构建流程配置错误。

报错原文

issue: prepare-pyodide.js can leave static/pyodide/ in a broken, non-functional half-state if interrupted mid-build

原因分析

可能原因：构建命令绕过了 package.json 中定义的 "build": "npm run pyodide:fetch && vite build" 链，直接调用 npx vite build，导致 prepare-pyodide.js 根本没有执行，static/pyodide/ 仅包含仓库中已提交的 pyodide-lock.json（约 147540 字节，是完整版本），而缺少实际运行时文件。

原 Issue 中关于“中断导致半成品”的理论已被报告者撤回。验证表明：pyodide-lock.json 是随代码仓库提交的固定文件；真正的构建中断会在 static/pyodide/ 留下不完整的 wheel 文件但没有锁文件，与观察到的现象不符。

环境排查

• 确认构建命令：在项目根目录运行 cat package.json | grep '"build"'，检查构建脚本是否包含 pyodide:fetch。
• 检查 static/pyodide/ 目录内容：是否存在 pyodide.js 文件，以及是否只有 pyodide-lock.json 而没有其他运行时文件。
• 确认 pyodide-lock.json 文件大小是否为 147540 字节（该值为 Issue 中确认的提交版本）。
• 检查 CI/CD 或部署脚本中是否有直接调用 vite build 的步骤。

解决步骤

1. 在 Open WebUI 项目根目录执行 npm run build，确保 pyodide:fetch 步骤先于 Vite 构建执行。
2. 构建完成后，检查 static/pyodide/pyodide.js 文件是否存在。如果缺失，说明 Pyodide 拉取步骤未执行或失败。
3. 如果使用自定义部署脚本（如 Dockerfile 或 CI 配置），将所有 npx vite build 替换为 npm run build。
4. 如果构建日志显示 pyodide:fetch 步骤失败（如网络问题），参考相关 Issue #27562 中提到的跳过方案处理。
5. 建议在构建后添加检查步骤，确认 pyodide.js 实际存在，避免静默产出损坏的构建。

验证方法

确认 static/pyodide/ 目录包含 pyodide.js 及完整的运行时文件；在浏览器中打开构建后的页面，测试 Pyodide 代码执行功能是否正常。也可以对比构建前后 pyodide-lock.json 的内容，确认拉取步骤执行后新增了 PyPI 包信息。

参考来源

open-webui/open-webui #28740

AI 工具推荐

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

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

了解 GamsGo AI

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