メインコンテンツへスキップ
技術

Shopifyのカート/チェックアウト検証エラーが表示されない?9つの原因と対処法

Jahangir Alam2026年11月21日2026年11月21日に事実確認済み17 min read

Shopifyの検証ルールでメッセージが表示されない場合、たいてい次の4つのうちのどれかが起きています。検証がオフになっている、Functionが失敗してチェックアウトが検証なしで続行された、ルールがチェックアウト時にしか実行されない、テーマがエラーを受け取ったのに表示していない、のいずれかです。 商品ページ、カート、チェックアウトを1つずつテストして、どれなのかを突き止めましょう。

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

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. 別のルールまたはアプリが先に失敗した注文ルールのチェック順を確認する
メッセージに'などのコードが表示される8. メッセージが二重にエスケープされたアプリの開発元に報告する
一切チェックされずに注文が入った9. 検証を行わない経路からの注文だったPOS、更新、編集、API経由の注文は検証されない

1. 検証が有効になっていない

検証Functionを含むアプリをインストールしても、自動でオンになるとは限りません。設定 → チェックアウト → チェックアウトルールを開き、アプリのルールが一覧にあり、オンになっていることを確認してください。オフの場合、そのアプリのルールはどの画面でも動きません。OrderRulesの場合は、ルールが適用されない場合のチェックリストが最初にここを確認します。

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

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

実際に問題になる制限は、200行までのカートで1回の実行あたり1,100万命令です。コストはカートの行数に応じて増えるため、3点のカートで動くルールが、40点のカートでは失敗することがあります。制限が小さなカートでは守られ、大きなカートでは守られないなら、これが原因の可能性が高いです。マーチャントはFunctionの実行ログを見られません。見られるのはアプリの開発元だけで、Partner Dashboardから確認できます。注文の時刻とカートの行数を伝えてください。制限の一覧はFunctionのリソース制限にあります。

3. ルールがチェックアウト時にしか実行されない

Shopifyは、購入者がカートを変更しているのか、チェックアウト中なのかをFunctionに伝えます。多くのアプリは、一部のルールをチェックアウトでしかチェックしません。お客様がまだ選んでいない配送日などが原因で、カートへの追加が失敗しないようにするためです。そうしたルールはカートページには何も表示せず、チェックアウトでブロックします。

OrderRulesでは、休業中、注文数の上限、商品とバリエーションの上限、最小数量とステップ数量、タグとコレクションの制限は、商品の追加時にチェックされます。顧客ごとの制限と、配送・受け取りのチェックは、チェックアウトでのみ実行されます。お客様がまだログインしていなかったり、日付を選んでいなかったりする可能性があるためです。チェックアウトの前にお客様に知らせたい場合は、ストアフロントメッセージでページ上にルールを表示してください。

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つのチェックアウトが、両方とも通ることもあります。消えたメッセージはありません。ルールは古い件数を見ていただけです。超えてはいけない上限には、少し余裕を持たせてください。顧客ごとの制限のカウント方法は、チェックアウトごと・顧客ごとの制限を参照してください。

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

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

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

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

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

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

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

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

請求書のチェックアウトで支払う下書き注文は、検証されます。OrderRulesでは、上記の経路からの注文はブロックされませんが、上限にはカウントされます。一覧表は互換性と制限にあります。

10分で全画面をテストする

開発ストアまたはテスト用の商品を使い、わざと破れるルール(たとえば最大2個)を設定します。

  1. 商品ページ: 3個を追加します。ボタンとメッセージの動きを記録します。
  2. コレクションのクイック追加: コレクションページから商品を追加します。
  3. カートページとドロワー: 数量を3に変更します。
  4. チェックアウト: カートに3個入れた状態でチェックアウトに進みます。メッセージが表示され、支払いに進めないはずです。
  5. Buy it nowとShop Pay: それぞれのボタンで、商品ページから3個購入します。
  6. ログイン状態とログアウト状態: 顧客ごとの制限を使う場合は、両方の状態でチェックアウトを繰り返します。
  7. 大きなカート: 小さな商品を多く扱うストアなら、40行以上を追加します。

テスト中は、ネットワークタブを開いたままにしてください。画面にメッセージが出ないままブロックされるステップは、テーマの問題(原因4)です。通ってはいけないのに通るステップは、原因1、2、5、9のいずれかです。

関連記事

出典

よくある質問

よくある原因は次のとおりです。検証が「設定 → チェックアウト → チェックアウトルール」でオンになっていない。Functionがクラッシュしたか命令数を使い切り、検証なしでチェックアウトが続行された。ルールがチェックアウト時にしか実行されないため、カートページには何も表示されない。テーマがカートのエラーを受け取って、汎用メッセージや「Sold out」に置き換えている。商品ページ、カート、チェックアウトを別々にテストして、どこで起きているかを確認してください。

チェックアウトでは、カート全体を対象にしたエラーは現在のチェックアウトのステップに表示され、フィールドを対象にしたエラーはそのフィールドの横に表示されます。オンラインストアでは、商品の追加や変更時に返されたエラーが、失敗したカートリクエストとしてテーマに戻されます。表示するかどうか、どこに表示するかはテーマ次第です。ヘッドレスのストアフロントは、Storefront APIのカートからエラーを読み取ります。

検証ルールがカート追加のリクエストを拒否した場合、失敗した追加をすべて売り切れとして扱うテーマがあります。たとえばDawnは、ボタンの下にエラーメッセージを表示しつつ、ボタンを「Sold out」(売り切れ)に切り替えることもあります。商品が在庫切れなのではなく、ルールがその数量またはそのカートをブロックしています。その商品にどのルールが適用されているかを確認してください。

デフォルトではブロックされません。大きなカートでタイムアウトしたり命令数を使い切ったりしてFunctionの実行が失敗した場合、アプリが作成時にblockOnFailureをオンにしていない限り、Shopifyはその検証なしでチェックアウトを続行させます。お客様にメッセージは表示されず、注文は通ります。

検証は、Shop Pay、Apple Pay、Google Pay、PayPalのエクスプレス決済、Buy it nowで実行されます。注意点が1つあります。商品ページからのエクスプレス決済はカート属性を引き継がないため、カートページでお客様が選んだ内容に依存するルール(たとえばカート属性として保存された配送日)は、そこでは参照できません。

POSでの販売、サブスクリプションの更新注文、注文の編集、APIで作成された注文、予約注文やお試し購入(try-before-you-buy)の購入では、カートとチェックアウトの検証が実行されないため、そのメッセージも表示されません。請求書のチェックアウトで支払う下書き注文では、検証が実行されます。

アプリを比較中ですか?

このカテゴリの他のShopifyアプリすべてとOrderRulesを比較してご覧ください。

注文管理を手中に収める準備はできていますか?

OrderRulesを無料で試す