Function 抛错导致结账中断怎么排查

现象#

进入结账页后提示「无法计算运费/折扣」，无法继续付款；移除函数后恢复正常。

原因#

• Wasm 运行时内存或执行时间超限
• 输入查询返回空对象时未做判空，直接取属性导致 trap
• 返回结构不符合 schema（金额为负、字段缺失）
• 函数版本与结账扩展的 API 版本不匹配

处理步骤#

1. 在开发店铺用 shopify app function run 复现，查看具体错误
2. 对所有可选输入做空值兜底，缺数据时返回空候选而不是报错
3. 校验返回值：金额非负、币种一致、必填字段齐全
4. 确认函数目标 API 版本与结账扩展一致，升级后重新部署

验收标准#

结账可正常走完；函数异常时降级为空结果而不是阻断支付。