Shopify 结账体验

升级 Checkout Extensibility 后自定义字段消失

现象#

升级前顾客能填配送备注和公司名,升级后这两个输入框没了,新订单的附加信息为空,只有历史订单还能看到旧值。

原因#

  • 旧字段靠 checkout.liquid 里的 attributes 输入框渲染,升级后模板不再执行
  • 升级不会把旧模板里的字段迁到扩展,必须按原 key 重写一遍
  • 历史订单的 note_attributes 是下单时的快照,不会随升级消失
  • 新结构下只有 applyAttributeChange 或 Cart 属性才会写进订单

处理步骤#

  1. 设置 → 结账 里确认已切到 Checkout Extensibility,旧模板只读保留作对照
  2. 用 purchase.checkout.block.render 重建输入框,写入 applyAttributeChange
  3. 对照旧模板里的字段 key,保证与 ERP、报表里的列名一致
  4. 必填校验先用 useBuyerJourneyIntercept,2026-07 之后迁到校验 Function
  5. 下测试单后在订单详情展开「其他详细信息」逐项核对字段

验收标准#

测试单的订单附加信息里同时出现 delivery_note 与 company,导出 CSV 对应列有值。

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