升级 Checkout Extensibility 后自定义字段消失
现象#
升级前顾客能填配送备注和公司名,升级后这两个输入框没了,新订单的附加信息为空,只有历史订单还能看到旧值。
原因#
- 旧字段靠
checkout.liquid里的 attributes 输入框渲染,升级后模板不再执行 - 升级不会把旧模板里的字段迁到扩展,必须按原 key 重写一遍
- 历史订单的
note_attributes是下单时的快照,不会随升级消失 - 新结构下只有
applyAttributeChange或 Cart 属性才会写进订单
处理步骤#
- 设置 → 结账 里确认已切到 Checkout Extensibility,旧模板只读保留作对照
- 用
purchase.checkout.block.render重建输入框,写入applyAttributeChange - 对照旧模板里的字段
key,保证与 ERP、报表里的列名一致 - 必填校验先用
useBuyerJourneyIntercept,2026-07 之后迁到校验 Function - 下测试单后在订单详情展开「其他详细信息」逐项核对字段
验收标准#
测试单的订单附加信息里同时出现 delivery_note 与 company,导出 CSV 对应列有值。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。