当 Shopify 验证规则不显示任何提示时,通常是四种情况之一:验证被关闭、Function 失败后结账继续进行、规则只在结账时运行,或者主题收到了错误却没有显示。 请依次测试商品页、购物车和结账,找出是哪一种。
本文介绍用 Shopify Functions 构建的结账验证,订单限制、最低订单和营业时间类应用(包括 OrderRules)正是用它来拦截订单。如果你刚接触,请先阅读 Shopify 结账验证的工作原理。
Shopify 在哪里显示验证错误
提示出现在哪里,取决于顾客当前所处的位置。
| 顾客所在位置 | 发生什么 | 谁来显示消息 |
|---|---|---|
| 结账 | 错误会拦截当前步骤。针对整个购物车的错误显示在当前结账页;针对字段的错误显示在该字段旁。 | Shopify |
| 商品页或购物车(添加或修改商品) | 购物车请求失败并返回错误。 | 你的主题,前提是它读取了错误 |
| Headless 店面 | 错误出现在 Storefront API 购物车上。 | 你的前端 |
| 快捷结账(Shop Pay、Apple Pay、Google Pay、PayPal、Buy it now) | 验证与结账中一样运行。 | Shopify |
提示丢失就发生在中间那一行。Shopify 会把错误送回来,但购物者能否看到,取决于主题的 JavaScript。
9 个原因,按症状排查
| 症状 | 可能原因 | 解决方法 |
|---|---|---|
| 任何地方都没有规则生效 | 1. 验证未启用 | 在结账规则中开启 |
| 小购物车正常,大购物车不行 | 2. Function 崩溃或指令数用尽 | 把时间和购物车行数告知应用开发者 |
| 购物车页面无提示,结账时被拦截 | 3. 规则只在结账时运行 | 属正常现象,提前告知顾客 |
| 显示“Sold out”(售罄)或通用错误,而非你的提示 | 4. 主题隐藏或替换了购物车错误 | 在 Dawn 中测试,修复主题的错误处理 |
| 从购物车正常,从 Buy it now 不行 | 5. 快捷结账跳过了购物车属性 | 按行项目保存选择,或在结账时要求选择 |
| 超出限制后的第一单仍然通过 | 6. 计数尚未更新 | 预留余量,计数在每个订单后刷新 |
| 显示了另一条消息 | 7. 另一条规则或应用先失败 | 检查订单规则的检查顺序 |
消息中显示 ' 或其他代码 | 8. 消息被重复转义 | 告知应用开发者 |
| 订单完全没有经过检查 | 9. 订单来自跳过验证的渠道 | POS、续订、编辑和 API 订单不会被验证 |
1. 验证未启用
安装带验证 Function 的应用,并不总会自动将其开启。前往 设置 → 结账 → 结账规则(Settings → Checkout → Checkout rules),确认该应用的规则已列出并已开启。如果是关闭的,该应用的规则在任何场景下都不会运行。对于 OrderRules,规则未生效检查清单会先带你检查这一项。
2. Function 崩溃、超时或指令数用尽
验证错误一定会拦截结账,但运行失败不会。如果 Function 抛出错误或超出 Shopify 的限制,结账默认会在没有该验证的情况下继续,顾客什么也看不到。应用可以在创建验证时通过 blockOnFailure 设置改变这一行为。
实际中最容易触发的限制是:最多 200 行的购物车,每次运行 1100 万条指令。成本随购物车每一行增加,所以在 3 件商品的购物车上正常的规则,在 40 件商品的购物车上可能失败。如果你的限制在小购物车上有效、在大购物车上失效,多半就是这个原因。商家看不到 Function 运行日志,应用开发者可以在其 Partner Dashboard 中查看。请把下单时间和购物车行数发给他们。完整限制列表见 Function 资源限制。
3. 规则只在结账时运行
Shopify 会告诉 Function 买家当前所处的环节:正在修改购物车,还是在结账中。许多应用只在结账时检查部分规则,这样加入购物车就不会因为顾客尚未选择的配送日期而失败。这类规则在购物车页面不显示任何内容,而是在结账时拦截。
在 OrderRules 中,店铺已打烊、订单上限、商品和变体上限、最低和步进数量,以及标签和商品系列限制,都在添加商品时检查。按客户限制以及配送和自提检查只在结账时运行,因为此时顾客可能还没登录或选好日期。如果你希望顾客在结账前就知道规则,可以用店面提示把规则显示在页面上。
4. 主题隐藏或替换了错误
当规则拒绝一次加入购物车或数量修改时,主题会收到一个包含消息的失败请求。接下来发生什么,取决于主题代码:
- Dawn(16.x)会在加入购物车按钮下方显示消息。它也可能把按钮切换为 “Sold out”(售罄),让商品看起来不可购买,其实并非如此。
- 商品系列页的快速添加按钮通常只显示“Sold out”(售罄)或简短的通用错误。
- 自定义购物车抽屉可能完全忽略错误,只是不添加商品。
确认是否为主题问题:打开浏览器开发者工具,进入 Network 标签页,再次添加该商品。如果失败的 /cart/add.js 或 /cart/change.js 请求的响应中包含你的消息,说明规则生效了,只是主题没有显示。请在未修改的 Dawn 预览中尝试同样的操作。如果 Dawn 能显示消息,就请主题开发者显示失败购物车请求返回的错误。
5. 快捷结账跳过了购物车属性
Shopify 的验证文档指出,从商品页发起的加速结账会跳过购物车属性。如果规则依赖顾客在购物车页面所选并保存为购物车属性的内容,例如配送日期或礼品留言,商品页上的 Buy it now 或 Shop Pay 按钮就不会发送它。视应用的构建方式,规则要么看不到这个选择,要么用“请选择日期”的消息拦截订单。
解决办法在应用一侧:把选择保存到每个行项目上(商品页按钮会携带行项目),或在结账中要求选择。OrderRules 会把在商品页选择的配送日期保存到行项目上,所以 Buy it now 订单会保留它。请在繁忙日之前,在你的店铺里测试这个按钮。
6. 计数尚未同步
Function 在结账期间无法调用应用的服务器。它读取的是应用之前保存的计数,应用会在每个订单后更新计数。所以达到上限后的第一次结账可能通过,同一时刻对最后一件商品的两次结账也可能都通过。这里并没有丢失消息,只是规则看到的是旧计数。对于不能超出的上限,请预留一点余量;客户限制如何计数,请参见按结账限制 vs 按客户限制。
7. 另一条规则或应用先给出了回应
Shopify 会运行每个已启用的验证 Function,每家店铺最多 25 个,任何一个返回错误都会拦截结账。在同一个应用内部,规则通常按固定顺序检查。在 OrderRules 中,店铺已打烊时只显示打烊消息,即使购物车同时也低于最低订单。顾客解决一个问题后,才会看到下一个。完整顺序见顾客会看到哪条消息。
如果消息根本不是来自你的应用,那就是另一个应用的验证在拦截。请查看 设置 → 结账 → 结账规则(Settings → Checkout → Checkout rules)下的列表。
8. 消息中显示代码
撇号显示成 ',或 & 符号显示成 &,说明消息在应用到页面之间被 HTML 重复转义了。这是应用或主题的显示错误,不是你的设置问题。请把具体页面和消息告知应用开发者。
9. 订单根本没有经过结账验证
有些订单完全不运行购物车和结账验证,所以没有消息可显示:
- Shopify POS 销售
- 订阅续订订单(首次订阅结账会被验证)
- 购买后的订单编辑
- 其他应用或集成通过 Create Order API 创建的订单
- 预售和先试后买购买
通过发票结账支付的草稿订单会被验证。在 OrderRules 中,来自上述渠道的订单不会被拦截,但仍会计入你的限制。完整表格见兼容性与限制。
10 分钟测试每个环节
使用开发店铺或测试商品,设置一条你能故意触发的规则,例如最多 2 件。
- **商品页:**添加 3 件。观察按钮和消息的反应。
- **商品系列快速添加:**在商品系列页添加该商品。
- **购物车页面和抽屉:**把数量改为 3。
- **结账:**购物车中有 3 件时进入结账。你应该看到消息,并且无法付款。
- **Buy it now 和 Shop Pay:**用每个按钮在商品页购买 3 件。
- **已登录和未登录:**如果使用按客户限制,两种状态下各重复一次结账。
- **大购物车:**如果你的店铺销售很多小件商品,添加 40 行或更多。
测试时保持 Network 标签页打开。任何被拦截但屏幕上没有消息的步骤,都是主题问题(原因 4)。任何不该通过却通过的步骤,是原因 1、2、5 或 9。
延伸阅读
来源
- Shopify.dev:Cart and Checkout Validation Function API(目标、买家流程步骤、失败运行与
blockOnFailure、支持的场景、加速结账与购物车属性) - Shopify.dev:Function APIs: resource limits
- Shopify Dawn on GitHub:
assets/product-form.js(加入购物车错误处理,版本 16.2.0)