店铺前台 500 但后台正常怎么定位

现象#

顾客打开首页报 500 或空白页，后台一切正常，切换主题后恢复正常。

原因#

• 主题 Liquid 抛出未捕获错误（常见于自定义 section 的空值处理）
• 应用注入的脚本或 App Embed 引用了已删除资源
• 主题引用的 assets 文件缺失，或 asset_url 路径写错
• 店铺达到 Liquid 渲染上限（循环或对象过大）

处理步骤#

1. 切到未改动的官方主题验证：若正常，问题在主题代码
2. 在主题副本上逐个关闭 section / App Embed，二分定位到具体位置
3. 查看页面返回的 HTML 中是否包含 Liquid 错误提示，定位到文件与行号
4. 对可疑 section 补空值兜底，如 {% if product %} 再取属性

验收标准#

前台恢复 200；开启全部 section 与 App 后仍稳定，控制台无报错。