---
title: "Shopifyのカート／チェックアウト検証エラーが表示されない？9つの原因と対処法"
description: "注文制限やチェックアウトルールを設定したのに、お客様にメッセージが表示されない、または「Sold out」と表示される。Shopifyが検証エラーを表示する場所、よくある9つの原因、各画面でのテスト方法を解説します。"
contentType: "blog"
locale: "ja"
localized: true
source: "https://orderrules.com/ja/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の検証ルールでメッセージが表示されない場合、たいてい次の4つのうちのどれかが起きています。検証がオフになっている、Functionが失敗してチェックアウトが検証なしで続行された、ルールがチェックアウト時にしか実行されない、テーマがエラーを受け取ったのに表示していない、のいずれかです。** 商品ページ、カート、チェックアウトを1つずつテストして、どれなのかを突き止めましょう。

このガイドで扱うのは、Shopify Functionsで作られたチェックアウト検証です。注文上限、最低注文額、営業時間のアプリ（OrderRulesを含む）は、この仕組みで注文をブロックします。初めての方は、先に[Shopifyのチェックアウト検証の仕組み](/blog/shopify-checkout-validation-functions-block-orders)をお読みください。

## Shopifyが検証エラーを表示する場所

メッセージが表示される場所は、お客様がどこにいるかで変わります。

| お客様がいる場所 | 何が起きるか | メッセージを表示するのは誰か |
|---|---|---|
| **チェックアウト** | エラーがそのステップをブロックします。カート全体のエラーは現在のチェックアウトページに、フィールドのエラーはそのフィールドの横に表示されます。 | Shopify |
| **商品ページまたはカート**（商品の追加・変更時） | カートリクエストが失敗し、エラーが返されます。 | **テーマ**（エラーを読み取る場合） |
| **ヘッドレスのストアフロント** | エラーは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を含むアプリをインストールしても、自動でオンになるとは限りません。**設定 → チェックアウト → チェックアウトルール**を開き、アプリのルールが一覧にあり、オンになっていることを確認してください。オフの場合、そのアプリのルールはどの画面でも動きません。OrderRulesの場合は、[ルールが適用されない場合のチェックリスト](/docs/troubleshooting/rules-not-applying)が最初にここを確認します。

### 2. Functionがクラッシュした、タイムアウトした、または命令数を使い切った

検証エラーは必ずチェックアウトをブロックしますが、**実行の失敗**はブロックしません。Functionがエラーを投げたり、Shopifyの制限を超えたりした場合、デフォルトではその検証なしでチェックアウトが続行され、お客様には何も表示されません。アプリは、検証を作成するときに`blockOnFailure`の設定でこれを変更できます。

実際に問題になる制限は、200行までのカートで**1回の実行あたり1,100万命令**です。コストはカートの行数に応じて増えるため、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」**（日本語のDawnでは「売り切れ」）に切り替えることもあるため、実際は購入できるのに、商品が買えないように見えます。
- **コレクションページのクイック追加ボタン**は、多くの場合「Sold out」や短い汎用エラーしか表示しません。
- **カスタムのカートドロワー**は、エラーをまったく無視して、商品を追加しないだけの場合があります。

テーマが原因かどうかを確かめるには、ブラウザの開発者ツールを開き、**ネットワーク**タブで商品をもう一度追加します。失敗した`/cart/add.js`または`/cart/change.js`のリクエストに、あなたのメッセージが含まれていれば、ルールは動いていて、テーマが表示しなかったということです。同じ操作を、編集していないDawnのプレビューで試してください。Dawnでメッセージが表示されるなら、失敗したカートリクエストのエラーを表示するよう、テーマの開発者に依頼しましょう。

### 5. エクスプレス決済がカート属性を引き継がなかった

Shopifyの検証リファレンスによると、**商品ページからのアクセラレーテッドチェックアウトは、カート属性を引き継ぎません**。お客様がカートページで選んでカート属性として保存した内容（配送日やギフトメモなど）にルールが依存している場合、商品ページのBuy it nowボタンやShop Payボタンはそれを送りません。アプリの作りによって、ルールがその選択を参照できないか、「日付を選んでください」というメッセージで注文をブロックします。

対処はアプリ側で行います。商品ページのボタンも引き継ぐ明細ごとに選択内容を保存するか、チェックアウトで選択を必須にします。OrderRulesは、商品ページで選ばれた配送日を明細に保存するので、Buy it nowの注文でも日付が保持されます。忙しい日の前に、このボタンをストアでテストしておきましょう。

### 6. 件数が追いついていなかった

Functionは、チェックアウト中にアプリのサーバーを呼び出せません。アプリが事前に保存した件数を読み取り、アプリは注文のたびにそれを更新します。そのため、上限に達した後の**最初の**チェックアウトが通ることがあり、最後の1個に対してほぼ同時に行われた2つのチェックアウトが、両方とも通ることもあります。消えたメッセージはありません。ルールは古い件数を見ていただけです。超えてはいけない上限には、少し余裕を持たせてください。顧客ごとの制限のカウント方法は、[チェックアウトごと・顧客ごとの制限](/blog/per-checkout-vs-per-customer-limits-shopify)を参照してください。

### 7. 別のルールまたはアプリが先に応答した

Shopifyは、有効なすべての検証Functionを（1ストアあたり最大25個）実行し、そのうち1つでもエラーを返せばチェックアウトはブロックされます。1つのアプリの中でも、ルールは決まった順序でチェックされることがよくあります。OrderRulesでは、カートが最低額に届いていなくても、休業中なら休業のメッセージだけが表示されます。お客様が1つ直すと、次のメッセージが表示されます。完全な順序は、[お客様に表示されるメッセージの順序](/blog/shopify-order-rules-recipes)を参照してください。

メッセージがあなたのアプリのものではない場合は、別のアプリの検証がブロックしています。**設定 → チェックアウト → チェックアウトルール**の一覧を確認してください。

### 8. メッセージにコードが表示される

アポストロフィが`&#39;`、アンパサンドが`&amp;`と表示される場合、メッセージがアプリからページに届くまでのどこかで、HTMLエスケープが二重にかかっています。設定ではなく、アプリまたはテーマの表示のバグです。該当のページと正確なメッセージを、アプリの開発元に報告してください。

### 9. 注文がチェックアウト検証を通らなかった

注文によっては、カートとチェックアウトの検証がまったく実行されないため、表示されるメッセージもありません。

- **Shopify POS**での販売
- **サブスクリプションの更新**注文（最初のサブスクリプションのチェックアウトは検証されます）
- 購入後の**注文の編集**
- 他のアプリや連携が**Create Order API**で作成した注文
- **予約注文とお試し購入（try-before-you-buy）**の購入

請求書のチェックアウトで支払う下書き注文は、検証**されます**。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行以上を追加します。

テスト中は、ネットワークタブを開いたままにしてください。画面にメッセージが出ないままブロックされるステップは、テーマの問題（原因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)
- GitHubのShopify Dawn：[`assets/product-form.js`](https://github.com/Shopify/dawn/blob/main/assets/product-form.js)（カート追加のエラー処理、バージョン16.2.0）
