プレビューと公開のトラブルシューティング

ストアフロント、ビルド、公開、チェックアウト、およびドメイン状態を最も安全な次のアクションと照合します。

エントリーパス: ワークスペース → ストアを選択 → ストアフロント → 画面に表示されているプレビューまたは公開状態を再現

このガイドの内容

どのレイヤーが失敗しているかを特定します。プロジェクトバージョン、プレビュー、ビルドチェック、公開、公開カタログ、チェックアウト、またはドメイン。最も安全な回復アクションを実行します。

この区別が重要な理由

ストアフロントの旅にはいくつかの独立したレイヤーがあります。公開を繰り返しても製品データの欠落は修正されず、プレビューを更新しても支払い接続は修復されません。失敗した正確なメッセージと表面から始めます。

利用可能性と前提条件

プロジェクトを開いたままにし、現在のバージョンラベルをメモします。
正確なメッセージ、ページパス、およびプレビューまたは公開 URL で失敗したかどうかを記録します。
アクティブな Runner 作業が完了、失敗、または停止に到達するまで待ってから、競合する回復アクションを開始します。
理論をテストするためだけにバージョンを削除、復元、または繰り返さないでください。

失敗しているレイヤーを見つける

ストアフロントで、現在のバージョンが存在するかどうかを確認します。
通常のプレビューが開くかどうかを確認します。
公開している場合は、別のアクションを選択する前にビルドチェックの結果を読みます。
公開が成功した場合は、プレビュー URL ではなく公開 URL を開きます。
公開ストアで、カタログとカートをテストします。
Runner のチェックアウトステータスと実際のチェックアウトパスを確認します。
カスタムアドレスのみが失敗する場合は、最後にドメイン設定を確認します。

重要な回復コントロール

コントロール	選択したときの動作
プレビューの更新	現在のプレビューを再度読み込み、アクティブなデザインモード選択とアンドゥ/リドゥセッションをクリアします。最初に保留中の直接編集を保存します。
修正 / エラーを修正	表示されたプレビュー診断を Runner に修復リクエストとして送信します。閉じるのみでメッセージを非表示にします。
AI で修正	公開確認を閉じ、ビルド失敗を Runner に送信して修復します。公開は開始されません。
チェックを再試行	Runner がワークスペースに到達できなかった後、ストアフロントビルドチェックを再度実行します。
ストア操作を開く	公開確認を閉じ、ストア操作を開いて、指定されたセットアップを完了できます。
セットアップステータスを再試行	ステータスが利用不可だった後、ストア操作の準備状況を再度確認します。
再公開	失敗またはリンクレスの結果後、新しいチェック済み公開試行を開始します。最初に指定された原因を修正します。
チェックアウトステータスを再試行	有効な支払い接続を再度確認します。製品、配送、またはチェックアウトフォームをテストしません。

英語の注釈で操作箇所を示しています。画像を選択すると拡大できます。

ビルド成功と設定警告は同時に表示されます。両方を読んで準備状態を判断します。画像は英語の画面です。

状態からアクションへの参照

メッセージまたは症状	レイヤー	意味	最も安全な次のアクション
準備済みのストア版がない	プロジェクトの版	プレビューできる版がありません。	最初のストアフロント作成を依頼します。
最初のバージョンを構築中…	プロジェクトバージョン	Runner はまだそれを作成しています。	タスク進行状況に従います。まだ公開しないでください。
バージョンのビルド失敗	プロジェクトバージョン	そのバージョンは準備ができていません。	タスク詳細を開き、Runner に失敗を修復するよう依頼します。
プレビューを準備中…	プレビュー	Runner は選択されたプレビューを開始しています。	最新バージョンを選択したままにします。進行が停止した場合のみ更新します。
このバージョンのプレビューを読み込めませんでした。ページを更新してもう一度お試しください。	プレビュー	選択されたバージョンを表示できませんでした。	現在に戻り、更新するか、別の準備完了バージョンを試します。
プレビューを再接続中	プレビュー	Runner はプレビュー接続を失い、再試行しています。	再試行回数に従います。回復が失敗した場合、ワークスペースを再接続します。
修正付きプレビューエラーバー	プレビュー	実行中のページは診断を報告し、Runner が使用できます。	詳細を表示で検査し、修正またはエラーを修正で Runner に送信するか、閉じるのみでバーを非表示にします。
ページが見つかりません	プレビューまたは公開ルート	パスはそのバージョンに存在しません。	`/` に戻り、表示されているナビゲーションを使用し、Runner にルートを作成または修復するよう依頼します。
デザインモードが開始されませんでした	デザインモード	編集可能なプレビューは準備ができませんでした。	もう一度試すを選択するか、現在のプレビューに戻り、更新します。
Runnerの処理が終わると、再びビジュアル編集できます。	デザインモード	別の依頼を処理中です。	完了を待ちます。
バージョン履歴の読み込みに失敗しました	バージョン履歴	バージョンリストリクエストが失敗しました。	もう一度試すを選択します。
復元がブロックされている	バージョン履歴	Runner がアクティブであるか、バージョンが準備ができていません。	Runner を待ってから、準備完了バージョンを選択します。
ワークスペースに接続できませんでした。再確認してください。	公開検査	ビルド検査を実行できません。	再確認し、再発したら再接続します。
ストアをビルドできないため、公開できません。Runnerでエラーを修正してから公開してください。	公開検査	ビルドに通りません。	AIで修正し、確認後に再検査します。
運営情報に未完了の項目があります。公開後にストア運営で完了できます。	公開設定	重要な設定が未完了です。	ストア運営を開くを選び、制限を意図する場合のみ了承します。
ストア運営を確認できませんでした。再試行するか、了承して公開してください。	公開設定	状態不明です。	了承前に設定状態を再確認します。
公開前にストアフロントに目に見える変更を加えてください。	公開の変更	前回から変更がありません。	キャンセルして変更します。変更なしでは確認は無効です。
閲覧はできますが、まだ支払いはできません。設定でStripeを接続してください。	購入設定	一部の手順では未接続時に公開前に表示します。	RunnerストアはStripeを接続します。閲覧専用を意図する場合のみ了承します。別の手順は公開後に表示します。
ストア公開に失敗しました	公開	試行は完了しませんでした。	指定された問題を修復してから、再公開を選択します。
ストアリンク利用不可	公開引き継ぎ	試行は Runner で使用可能なリンクなしで完了しました。	ダイアログを閉じ、ワークスペースが準備できていることを確認してから、再公開を選択します。
公開ストアが古いコンテンツを表示	公開またはバージョン	現在のプロジェクト変更はライブではありません。	最新の現在のバージョンを確認し、変更を公開を選択して、再度開きます。
公開ストアで製品が欠落	カタログ	公開は成功しましたが、目的の製品は表示されません。	製品ステータス、市場、価格、およびインベントリを確認します。必要に応じて変更を公開します。
カートアクション欠落または無効	カタログまたは可用性	選択されたアイテムは現在追加できません。	必要なオプション、可用性、在庫、価格、および地域を確認します。
チェックアウト一時停止	支払い	公開後のフローは有効な Stripe 接続を見つけませんでした。	Stripe に接続を選択してから、実際のチェックアウトパスを再度テストします。
チェックアウトステータス利用不可	支払いステータス	Runner は支払い準備を確認できません。	チェックアウトステータスを再試行を選択し、公開チェックアウトを独立してテストします。
所有カスタムドメインに赤い警告とタイプ / ホスト / 値の表が表示される	ドメイン	プロバイダーの現在の設定チェックがまだ成功していません。	表示値を正確にプロバイダーへコピーします。ドメイン設定を開いている間はRunnerが自動的に再確認します。手動の確認ボタンはありません。
転送進行中	ドメイン	ドメインはストア間で移動しています。	別の転送を開始しないでください。表示されたステータスに従います。

復旧を確認する

失敗したページ、版、端末幅へ戻り、失敗した最小の操作を一度繰り返します。プレビュー準備完了、公開URLの正しいページ、正しいカート、ドメインの動作などを確認します。まだ失敗する手順は別に記録します。

Runner に問題を報告する

1 つのメッセージに次の詳細を含めます:

正確なページパスまたは公開 URL;
プレビューまたはライブストアで失敗したかどうか;
現在のバージョンラベル;
正確なエラーまたは状態テキスト;
最後に選択したボタン;
予想される結果; および
記載されている再試行アクション後に問題が再現されるかどうか。

ビジュアル問題の場合は、デバイスレイアウトとスクリーンショットを含めます。チェックアウトの場合は、実際の請求の前に停止し、最後に成功したステップを報告します。

回復の境界

変更されていない失敗した状態を繰り返し再開または再公開しないでください。最初に指定された原因を修正します。
Runner が作業中の間、古いバージョンを復元しないでください。
ストアフロントまたはチェックアウト問題を修正するためにドメインを削除しないでください。
公開 URL、目的のカタログ、カート、および必要なチェックアウトステップのそれぞれが確認されるまで、起動成功を主張しないでください。