---
title: プレビューと公開のトラブルシューティング
description: ストアフロント、ビルド、公開、チェックアウト、およびドメイン状態を最も安全な次のアクションと照合します。
---

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

## このガイドの内容

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

## この区別が重要な理由

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

## 利用可能性と前提条件

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

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

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

## 重要な回復コントロール

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

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

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

## Runner に問題を報告する

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

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

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

## 回復の境界

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

## 関連ガイド

- [ストアをプレビューする](./preview-your-store)
- [公開前に準備する](./prepare-to-publish)
- [公開と再公開](./publish-and-republish)
- [ライブストアとチェックアウトを確認する](./live-store-and-checkout)
- [カスタムドメインに接続する](./custom-domains)