结账页整页 500 后台却一切正常怎么定位

现象#

购物车能打开，点「结账」后整页白屏，Network 里 checkouts 请求返回 500，后台订单与商品都正常。

原因#

• Plus 店铺的 checkout.liquid 有 Liquid 异常，残留的 include 也会报错
• Function 返回非法 operation 或执行超时，结账渲染中断
• 购物车里的 metafield 类型与函数输入查询不匹配
• 支付或配送应用在结账时请求超时，Shopify 直接返回错误页

处理步骤#

1. 无痕窗口复现，记录 checkouts 请求响应头里的 x-request-id
2. 临时停用最近安装的结账类应用，再点一次结账做一次验证
3. 检查 设置 → 结账 是否已升级，旧 checkout.liquid 是否仍被引用
4. 本地跑 shopify app function run，确认函数没有 panic
5. 拿 request id 找 Shopify 支持查服务端日志

验收标准#

同一购物车重新点结账能进入联系方式步骤，Network 里 checkouts 返回 200，页面不再白屏。