---
title: "Shopify 结账验证的工作原理（以及应用如何用它拦截订单）"
description: "Shopify 的 Cart and Checkout Validation Functions 如何运作：在哪里运行、在哪里不运行，Function 能看到哪些数据，能做什么、不能做什么，哪些套餐可以使用，以及 OrderRules 这类应用如何用它拦截订单。"
contentType: "blog"
locale: "zh"
localized: true
source: "https://orderrules.com/zh/blog/shopify-checkout-validation-functions-block-orders"
slug: "shopify-checkout-validation-functions-block-orders"
date: "2026-05-03"
tags:
  - "shopify"
  - "checkout validation"
  - "shopify functions"
  - "server-side validation"
  - "block checkout outside business hours"
  - "order limits"
---
**Shopify 结账验证是应用安装到你店铺的一个 Shopify Function，来自 Cart and Checkout Validation API。** 每当购物车或结账发生变化，Shopify 就会在自己的服务器上运行它。如果 Function 返回错误，结账页面会显示该消息，买家在解决问题前无法完成下单。只要来自公开应用，它在任何 Shopify 套餐上都能运行，覆盖普通结账、Shop Pay 和 Apple Pay 等快捷按钮、headless 结账以及草稿订单。它不在 POS、订阅续订、订单编辑或通过 API 创建的订单上运行。它可以拦截订单，但不能修改购物车，也不能预留库存。

最后核实：**2026 年 10 月 8 日**，依据 Shopify 开发者文档和帮助中心。来源列在文末。

*声明：OrderRules 是一款结账验证应用。本指南先讲解 Shopify 平台本身，再说明我们如何使用它。*

![结账验证与购物车脚本类应用在标准结账、Shop Pay、Apple Pay、Google Pay、直接结账链接和 headless 店面上的对比](/images/blog/shopify-checkout-validation-functions-block-orders.png)

## 什么是验证 Function

Shopify Functions 允许应用把自己的逻辑加入 Shopify 后端。每个 Function API 负责一件事：折扣、配送选项、付款方式等等。验证就是决定一个购物车能否结账的那一个。

它的工作方式如下：

1. **由应用提供 Function。** 它被编译为 WebAssembly，随应用一起部署。你只需安装应用，不用碰代码。
2. **由 Shopify 运行，而不是你的主题。** Function 在 Shopify 的基础设施内运行，而不是在购物者的浏览器里。关闭 JavaScript 或修改页面都无法跳过它。
3. **读取输入，返回错误。** Shopify 传入购物车及相关数据。Function 返回一个错误列表，每个错误包含一条消息和一个目标（整个购物车，或某个特定字段）。
4. **结账显示消息。** 列表为空：结账继续。有任何错误：Shopify 显示消息，并在买家做出修改前阻止完成订单。

Shopify 会在买家旅程的多个节点运行该 Function：购物车交互、结账交互和结账完成时。Function 可以判断当前处于哪一步，并选择只在结账时拦截，这样加入购物车就永远不会失败。

Shopify 要求 Functions 小而快。每次运行对指令数和输入大小都有严格限制，所以逻辑必须简单，数据必须精简。

下面是当前目标 `cart.validations.generate.run` 的一个简化 JavaScript 示例。仅作说明，并非 OrderRules 的代码：

```javascript
// Simplified example, not production code.
// Input comes from a GraphQL input query (cart lines, buyer identity, metafields).
export function cartValidationsGenerateRun(input) {
  const limits = input.shop.limits?.jsonValue ?? {}; // written by the app ahead of time
  const errors = [];

  for (const line of input.cart.lines) {
    const productId = line.merchandise.product?.id;
    const remaining = limits[productId];
    if (remaining !== undefined && line.quantity > remaining) {
      errors.push({
        message: `Only ${remaining} left for today. Lower the quantity to continue.`,
        target: "$.cart",
      });
    }
  }

  return { operations: [{ validationAdd: { errors } }] };
}
```

注意缺了什么：没有数据库查询，没有 API 调用，没有“统计今天的订单”。Function 只能看到输入中的内容。下文的一切都由此决定。

## 在哪里运行，在哪里不运行

Shopify 在文档中说明了哪些场景会运行验证 Function。下表依据 Cart and Checkout Validation API 参考文档整理。

| 场景 | 是否运行验证？ | 说明 |
|---|---|---|
| 在线商店购物车和结账 | **是** | 购物车和结账分别列出；两者都支持 |
| Shop Pay、Apple Pay、Google Pay、PayPal 快捷支付、Buy it now | **是** | 列为 Storefront Accelerated Checkout |
| Headless 店面（Storefront API） | **是** | 包括 Hydrogen 和自定义前端 |
| B2B 结账 | **是** | 公司买家接受同样的验证 |
| 草稿订单（后台和发票结账） | **是** | 列为 Draft Order (Admin and Checkout) 和 Shopify Admin |
| Shopify POS | **否** | 门店销售不经过验证 |
| 订阅续订订单 | **否** | 只有首次订阅结账会被验证 |
| 订单编辑 | **否** | 购买后编辑订单会跳过验证 |
| Create Order API | **否** | 由其他应用或集成创建的订单 |
| 预售和先试后买 | **否** | 不支持延迟购买选项 |

所以“无法绕过”的说法并不准确。购物者无法从在线商店或快捷按钮跳过验证。但来自 POS、续订、编辑或 API 的订单根本不会经过它。如果你依赖某项限制，请确认你的店铺用到了哪些渠道。

## Function 能看到什么

Function 声明一个用 GraphQL 编写的 **输入查询**，Shopify 在每次运行时填充它。常用字段包括：

- **购物车行：** 数量、变体、商品、重量、行属性。
- **买家身份：** 买家是否已登录；对于客户，还有订单数和消费金额等字段。
- **元字段：** 店铺、商品、变体和客户上的元字段。
- **购物车属性：** 例如在购物车页面选择的配送日期。
- **买家旅程所处步骤：** 购物车交互、结账交互或结账完成。

在公开应用中它不能做的事：访问网络。它无法在结账时询问应用的服务器“今天有多少订单？”。取而代之的是，应用在别处完成计数。它监听 Shopify 的订单通知，更新总数，并写入元字段。Function 在下一次运行时读取这些元字段。

这就是为什么 Function 中的计数是 **快照**。它们的新鲜程度取决于最后一次元字段写入，而不是实时数据。

## 它能做什么，不能做什么

**它可以用一条消息拦截。** 这就是它全部的输出。消息可以针对整个购物车或某个特定的结账字段，应用也可以让你自己撰写措辞。

**它不能修改数量。** 验证 Function 无法降低数量、移除某一行或修改价格。旧的 Shopify Scripts 可以悄悄修改购物车；验证不行。买家阅读消息后自己调整购物车。其他 Function API（如 Cart Transform 或折扣）负责修改购物车，但它们不会阻止结账。

**它不能预留库存或名额。** Function 读取一份快照，然后回答是或否。它不会锁定任何东西。如果两位买家几乎同时为最后一件商品、或某个配送时间段的最后一个名额结账，两人都可能读到“剩余 1”，并且都能通过。验证能让限制在正常流量下可靠生效，但不能保证你永远不会超出。

**每个店铺最多 25 个验证 Function。** Shopify 限制了可同时启用的验证 Function 数量。多个应用可以各自添加一个，它们都会运行；其中任意一个返回错误，就会阻止结账。

## 套餐

- **带 Functions 的 App Store 公开应用在所有 Shopify 套餐上都能用。** 安装验证应用不需要 Plus。
- **带 Functions 的自定义应用需要 Shopify Plus。** 这适用于自建私有 Function 的店铺。
- **Shopify Scripts 已经退出。** Scripts 于 2026 年 6 月 30 日停止运行。很多数量限制过去写在行项目脚本里。如果你的也是，请参见 [用 Functions 替代 Shopify Scripts 实现数量和结账规则](/blog/shopify-scripts-to-functions-order-limits)。

## 主题 JavaScript 与验证对比

许多限制工具运行在主题中：隐藏按钮、限制数量输入框，或在购物车页面显示警告。这对提前展示限制很有用，但它不是强制执行。

| | 主题或购物车页面 JavaScript | 验证 Function |
|---|---|---|
| 普通在线商店结账 | 仅当买家经过购物车页面且开启了 JavaScript | **是** |
| 商品页面上的 Shop Pay、Apple Pay、Google Pay 按钮 | 否，它们会跳过购物车页面 | **是** |
| 直接结账链接 | 否 | **是** |
| Headless 店面 | 否，没有主题 | **是** |
| 草稿订单 | 否 | **是** |
| POS | 否 | 否 |
| 订阅续订、订单编辑、API 订单 | 否 | 否 |
| 能在结账前展示限制 | **是** | 否，只在检查购物车时显示消息 |
| 关闭 JavaScript 即可跳过 | 是 | 否 |

两者都覆盖不了 POS 或续订。最好的方案是两者并用：用店面提示让购物者提前看到限制，用验证 Function 在结账时做最后的硬性拦截。

配送日期也是同样的道理。日期选择器会在浏览器中把已满或休息的日期置灰，但快捷按钮和直接结账链接会跳过日历所在的页面。只有验证 Function 会在结账时重新检查所选日期。参见 [Shopify 配送日期选择器应用的结账验证对比](/blog/best-shopify-delivery-date-picker-apps)。

## OrderRules 如何使用它

OrderRules 会安装一个验证 Function。你在应用中设置规则；应用负责计数并写入元字段；Function 在结账时读取它们，拦截违反规则的订单。它检查：

- **营业时间和节假日：** 在营业时间之外关闭结账。
- **订单上限：** 全店每日上限，付费套餐还有每周和每月上限。
- **商品、变体和商品系列上限：** 所有购物者共享的总量。
- **最小起订量和步进数量：** 按商品或变体、按订单计算。
- **按客户限制：** 针对已登录客户，按周期限制订单数、件数、消费金额或重量。
- **配送日期和自提时间段**（Advanced 套餐）：截单时间、不可选日期以及每个时间段的上限。

每种规则类型的提示消息都可以在设置中编辑。在上表中所有运行验证的场景，规则都会被检查。POS 订单和续订不会被拦截，但仍会计入你的限制。计数是快照，所以两个几乎同时争夺最后一个名额的结账可能都会通过。

结账强制执行包含在所有套餐中，包括免费的 Starter 套餐。完整说明：[OrderRules 规则在哪里检查：兼容性与限制](/docs/guides/compatibility-and-limitations)。

## 延伸阅读

- [如何在 Shopify 上设置订单限制](/blog/how-to-set-order-limits-shopify)
- [防止超卖：产能受限店铺的应对策略](/blog/prevent-overselling-shopify)
- [按客户订单限制指南](/blog/per-customer-order-limits-shopify-guide)
- [动态店面提示](/docs/guides/storefront-messaging)
- [最佳 Shopify 配送日期选择器应用：结账验证对比](/blog/best-shopify-delivery-date-picker-apps)
- [Shopify 配送日期校验：检查项目与顾客看到的提示](/blog/shopify-delivery-date-validation)
- [Shopify 原生订单限制 vs 应用（2026）](/blog/shopify-native-order-limits-vs-orderrules)
- [OrderRules 规则在哪里检查：兼容性与限制](/docs/guides/compatibility-and-limitations)
- [用 Functions 替代 Shopify Scripts 实现数量和结账规则](/blog/shopify-scripts-to-functions-order-limits)

## 来源

- Shopify.dev：[Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation)（目标、支持与不支持的场景、每店上限）
- Shopify.dev：[构建购物车和结账验证 Function](https://shopify.dev/docs/apps/build/checkout/cart-checkout-validation)
- Shopify.dev：[Shopify Functions](https://shopify.dev/docs/apps/build/functions)（公开应用与自定义应用的套餐可用性）
- Shopify.dev 更新日志：[Shopify Scripts 将于 2026 年 6 月 30 日弃用](https://shopify.dev/changelog/shopify-scripts-will-be-deprecated-on-june-30-2026)
- Shopify 帮助中心：[从 Scripts 过渡到 Functions](https://help.shopify.com/en/manual/checkout-settings/script-editor/transitioning-to-functions)

## 在你的店铺试用

从 [Shopify App Store](https://apps.shopify.com/orderrules-limit-sales?utm_source=blog&utm_medium=inline_cta&utm_campaign=shopify-checkout-validation-functions-block-orders) 安装 OrderRules。所有套餐都包含结账验证，付费套餐提供 14 天免费试用。
