---
title: "Shopify 购物车或结账验证错误不显示？9 个原因与解决方法"
description: "你设置了订单限制或结账规则，顾客却看不到提示，或只看到「售罄」。本文介绍 Shopify 在哪里显示验证错误、最常见的 9 个原因，以及如何测试每个环节。"
contentType: "blog"
locale: "zh"
localized: true
source: "https://orderrules.com/zh/blog/shopify-checkout-validation-error-not-showing"
slug: "shopify-checkout-validation-error-not-showing"
date: "2026-11-21"
tags:
  - "shopify"
  - "checkout validation"
  - "shopify functions"
  - "troubleshooting"
  - "order limits"
  - "cart"
---
**当 Shopify 验证规则不显示任何提示时，通常是四种情况之一：验证被关闭、Function 失败后结账继续进行、规则只在结账时运行，或者主题收到了错误却没有显示。** 请依次测试商品页、购物车和结账，找出是哪一种。

本文介绍用 Shopify Functions 构建的结账验证，订单限制、最低订单和营业时间类应用（包括 OrderRules）正是用它来拦截订单。如果你刚接触，请先阅读 [Shopify 结账验证的工作原理](/blog/shopify-checkout-validation-functions-block-orders)。

## 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. 另一条规则或应用先失败 | 检查订单规则的检查顺序 |
| 消息中显示 `&#39;` 或其他代码 | 8. 消息被重复转义 | 告知应用开发者 |
| 订单完全没有经过检查 | 9. 订单来自跳过验证的渠道 | POS、续订、编辑和 API 订单不会被验证 |

### 1. 验证未启用

安装带验证 Function 的应用，并不总会自动将其开启。前往 **设置 → 结账 → 结账规则**（Settings → Checkout → Checkout rules），确认该应用的规则已列出并已开启。如果是关闭的，该应用的规则在任何场景下都不会运行。对于 OrderRules，[规则未生效检查清单](/docs/troubleshooting/rules-not-applying)会先带你检查这一项。

### 2. Function 崩溃、超时或指令数用尽

验证错误一定会拦截结账，但**运行失败**不会。如果 Function 抛出错误或超出 Shopify 的限制，结账默认会在没有该验证的情况下继续，顾客什么也看不到。应用可以在创建验证时通过 `blockOnFailure` 设置改变这一行为。

实际中最容易触发的限制是：最多 200 行的购物车，**每次运行 1100 万条指令**。成本随购物车每一行增加，所以在 3 件商品的购物车上正常的规则，在 40 件商品的购物车上可能失败。如果你的限制在小购物车上有效、在大购物车上失效，多半就是这个原因。商家看不到 Function 运行日志，应用开发者可以在其 Partner Dashboard 中查看。请把下单时间和购物车行数发给他们。完整限制列表见 [Function 资源限制](/blog/shopify-checkout-validation-functions-block-orders)。

### 3. 规则只在结账时运行

Shopify 会告诉 Function 买家当前所处的环节：正在修改购物车，还是在结账中。许多应用只在结账时检查部分规则，这样加入购物车就不会因为顾客尚未选择的配送日期而失败。这类规则在购物车页面不显示任何内容，而是在结账时拦截。

在 OrderRules 中，店铺已打烊、订单上限、商品和变体上限、最低和步进数量，以及标签和商品系列限制，都在添加商品时检查。按客户限制以及配送和自提检查只在结账时运行，因为此时顾客可能还没登录或选好日期。如果你希望顾客在结账前就知道规则，可以用[店面提示](/docs/guides/storefront-messaging)把规则显示在页面上。

### 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 按客户限制](/blog/per-checkout-vs-per-customer-limits-shopify)。

### 7. 另一条规则或应用先给出了回应

Shopify 会运行每个已启用的验证 Function，每家店铺最多 25 个，任何一个返回错误都会拦截结账。在同一个应用内部，规则通常按固定顺序检查。在 OrderRules 中，店铺已打烊时只显示打烊消息，即使购物车同时也低于最低订单。顾客解决一个问题后，才会看到下一个。完整顺序见[顾客会看到哪条消息](/blog/shopify-order-rules-recipes)。

如果消息根本不是来自你的应用，那就是另一个应用的验证在拦截。请查看 **设置 → 结账 → 结账规则**（Settings → Checkout → Checkout rules）下的列表。

### 8. 消息中显示代码

撇号显示成 `&#39;`，或 & 符号显示成 `&amp;`，说明消息在应用到页面之间被 HTML 重复转义了。这是应用或主题的显示错误，不是你的设置问题。请把具体页面和消息告知应用开发者。

### 9. 订单根本没有经过结账验证

有些订单完全不运行购物车和结账验证，所以没有消息可显示：

- **Shopify POS** 销售
- **订阅续订**订单（首次订阅结账会被验证）
- 购买后的**订单编辑**
- 其他应用或集成通过 **Create Order API** 创建的订单
- **预售和先试后买**购买

通过发票结账支付的草稿订单**会**被验证。在 OrderRules 中，来自上述渠道的订单不会被拦截，但仍会计入你的限制。完整表格见[兼容性与限制](/docs/guides/compatibility-and-limitations)。

## 10 分钟测试每个环节

使用开发店铺或测试商品，设置一条你能故意触发的规则，例如最多 2 件。

1. **商品页：**添加 3 件。观察按钮和消息的反应。
2. **商品系列快速添加：**在商品系列页添加该商品。
3. **购物车页面和抽屉：**把数量改为 3。
4. **结账：**购物车中有 3 件时进入结账。你应该看到消息，并且无法付款。
5. **Buy it now 和 Shop Pay：**用每个按钮在商品页购买 3 件。
6. **已登录和未登录：**如果使用按客户限制，两种状态下各重复一次结账。
7. **大购物车：**如果你的店铺销售很多小件商品，添加 40 行或更多。

测试时保持 Network 标签页打开。任何被拦截但屏幕上没有消息的步骤，都是主题问题（原因 4）。任何不该通过却通过的步骤，是原因 1、2、5 或 9。

## 延伸阅读

- [Shopify 结账验证的工作原理](/blog/shopify-checkout-validation-functions-block-orders)
- [规则未生效：OrderRules 检查清单](/docs/troubleshooting/rules-not-applying)
- [OrderRules 规则在哪里检查：兼容性与限制](/docs/guides/compatibility-and-limitations)
- [动态店面提示](/docs/guides/storefront-messaging)

## 来源

- Shopify.dev：[Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation)（目标、买家流程步骤、失败运行与 `blockOnFailure`、支持的场景、加速结账与购物车属性）
- Shopify.dev：[Function APIs: resource limits](https://shopify.dev/docs/api/functions)
- Shopify Dawn on GitHub：[`assets/product-form.js`](https://github.com/Shopify/dawn/blob/main/assets/product-form.js)（加入购物车错误处理，版本 16.2.0）
