每日整理真实提问 356 个问题 · 726 个回答 需要系统性的技术文档?看 Shopify 技术百科 1000 篇 → 400-873-8117
已解决 提问于 1 个月前

Oxygen 部署一直失败

2 个回答 614 次浏览 Headless 与 Hydrogen 最后活跃 1 个月前
8

本地能跑,shopify hydrogen deploy 在构建阶段报错退出。

陈
陈工提问者
Shopify 认证开发者 · 专注主题与 Liquid
1 个月前提问 · 已收到 2 个回答

2 个回答

已采纳 · 提问者确认解决
52

先把判断放在前面:构建环境与本地环境差异,常见是环境变量缺失或 Node 版本不匹配。

1处理顺序

  1. 在 shopify hydrogen env pull 后确认环境变量完整。
  2. 检查 package.json 的 engines 字段与构建环境一致。
  3. 本地跑一次 npm run build 复现。
  4. 查看部署日志里的具体错误行,不要只看最后一行。
  5. 确认没有引用本地绝对路径的资源。
验收:部署成功,预览地址可访问,功能正常。
风 风格技术团队 回答于 1 个月前
16

Oxygen 的构建缓存有时会导致「本地能过、线上不过」。清一次缓存重新部署,能排除这类问题。

泽 阿泽 · 前端工程师 · 1 个月前

你的处理方式是什么?

写下你实际验证过的步骤,比「我也有这个问题」有用得多。当前版本为静态展示,提交后会由团队整理并回复。

描述你遇到的现象、店铺环境(主题 / 套餐 / 应用)、已经试过哪些操作……
我要单独提问 工作日 10 分钟内回复,可直接加微信 fenggejishu