Shopify Cart Transform 合并行项目不生效怎么查

现象#

配置了 bundle 合并逻辑，结账页仍然按单件显示，赠品没有合并成一组。

原因#

• Function 未在店铺启用或未发布
• 返回的 operations 结构与 API 版本不匹配
• 合并条件依赖的 metafield 未读取到

处理步骤#

1. 确认 Function 已在「设置 → 结账 → Cart Transform」启用
2. 用 cartTransformCreate 绑定 Function ID
3. 检查返回的 merge 操作里 parentVariantId 与 image、title 必填项
4. 用真实购物车测试并查看 Function 运行日志

验收标准#

购物车中相关行项目合并为一条，价格与数量正确，结账金额与后台一致。