Shopify 应用嵌入在结账页不生效怎么办

现象#

应用在商品页正常显示，到结账页就消失；商家以为是应用坏了，实际是结账页不再支持 app embed。

原因#

• 结账页已升级为 Checkout Extensibility，只支持 checkout UI extension，不再执行 app embed 脚本
• 应用只声明了 theme app extension，没有提供结账扩展
• 旧脚本依赖 checkout.liquid，该文件已停止渲染
• 结账页的 CSP 与脚本沙箱限制第三方脚本访问 DOM

处理步骤#

1. 确认店铺结账类型：设置 → 结账 → 是否已升级到 Extensibility
2. 改用 Checkout UI Extension，在 checkout 目标位注册扩展
3. 需要像素类埋点时改用 Web Pixel 扩展，而不是注入脚本
4. 历史逻辑迁移：把 DOM 操作改为扩展 API 提供的组件与指令

验收标准#

结账页能看到应用提供的界面或埋点数据，订单属性正确写入，控制台无 CSP 报错。