主题缺少 cart.json 导致购物车页面打不开
现象#
点页头购物车图标跳到 /cart 返回 404,或只渲染出一个空白页;主题目录里只有 cart.liquid,没有 cart.json。
原因#
- OS 2.0 主题的 /cart 由
templates/cart.json驱动,缺失时没有可渲染模板 - cart.json 引用的 section 文件不存在或 type 写错,渲染中断后退回错误页
- 从旧版本升级时只搬了 sections 目录,没搬 templates 下的 JSON 文件
- 应用把购物车改成抽屉式后删掉了 cart 模板,直接访问该 URL 就落到 404
处理步骤#
- 在
templates/下新建cart.json - 只保留
sections与order两个键,main.type填真实的购物车 section 文件名 - 确认该 section 存在,且内部有购物车表单或 cart 对象输出
- 推送后在编辑器打开 Cart 模板,确认可以添加区块
- 抽屉与独立购物车页并存时保留 cart.json,供直接访问与无障碍回退
验收标准#
直接访问 /cart 返回 200 并渲染购物车表单,编辑器模板下拉中能看到 Cart。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。