Shopify 报错排障

Shopify 页面某个区块空白但不报错怎么查

现象#

首页中间一块内容完全不显示,控制台没有错误,编辑器里该 section 显示正常。

原因#

  • section 的 enabled 为 false 但仍在模板里
  • 循环的数据源为空(集合无商品、菜单无链接)
  • CSS display:none 或高度为 0
  • Liquid 里 {% if %} 条件把整段包住且未命中

处理步骤#

  1. 在页面源码搜索该 section 的 id,确认 HTML 是否输出
  2. 有 HTML 但不可见 → 检查计算样式与高度
  3. 无 HTML → 在 section 顶部输出 {{ section.settings | json }} 与数据源变量
  4. 给空数据加占位提示,避免商家误以为坏了

验收标准#

区块正常渲染;数据为空时显示明确占位文案而不是空白。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。