---
title: Fehlerbehebung bei Vorschau und Veröffentlichung
description: Ordnen Sie Storefront-, Build-, Veröffentlichungs-, Checkout- und Domain-Zustände der sichersten nächsten Aktion zu.
---

**Eingabepfad:** Workspace → Speicher auswählen → **Storefront** → Reproduzieren Sie den auf dem Bildschirm angezeigten Vorschau- oder Veröffentlichungsstatus

## Was dieser Leitfaden abdeckt

Identifizieren Sie, welche Schicht fehlschlägt – Projektversion, Vorschau, Build-Prüfung, Veröffentlichung, öffentlicher Katalog, Checkout oder Domain – und ergreifen Sie die kleinste sichere Wiederherstellungsaktion.

## Warum diese Unterscheidung wichtig ist

Die Storefront-Reise hat mehrere unabhängige Schichten. Das Wiederholen von **Veröffentlichen** kann fehlende Produktdaten nicht beheben, und das Aktualisieren der Vorschau kann eine Zahlungsverbindung nicht reparieren. Beginnen Sie mit der genauen Nachricht und der Oberfläche, die fehlgeschlagen ist.

## Verfügbarkeit und Voraussetzungen

- Halten Sie das Projekt offen und notieren Sie die aktuelle Versionsbeschriftung.
- Notieren Sie die genaue Nachricht, den Seitenpfad und ob sie in der Vorschau oder auf der öffentlichen URL angezeigt wurde.
- Warten Sie, bis aktive Runner-Arbeit **Abgeschlossen**, **Fehlgeschlagen** oder **Gestoppt** erreicht, bevor Sie eine konfliktfreie Wiederherstellungsaktion starten.
- Entfernen Sie nicht Domains, stellen Sie Versionen nicht wieder her oder wiederholen Sie nicht bezahlte Aktionen, um eine Theorie zu testen.

## Finden Sie die fehlgeschlagene Schicht

1. Überprüfen Sie in **Storefront**, ob eine aktuelle Version vorhanden ist.
2. Bestätigen Sie, ob die normale Vorschau geöffnet wird.
3. Wenn Sie veröffentlichen, lesen Sie das Ergebnis der Build-Prüfung, bevor Sie eine andere Aktion auswählen.
4. Wenn die Veröffentlichung erfolgreich ist, öffnen Sie die öffentliche URL statt der Vorschau-URL.
5. Testen Sie im öffentlichen Speicher den Katalog und den Warenkorb.
6. Überprüfen Sie den Checkout-Status von Runner und den tatsächlichen Checkout-Pfad.
7. Wenn nur die benutzerdefinierte Adresse fehlschlägt, überprüfen Sie zuletzt die Domain-Einstellungen.

## Wichtige Wiederherstellungssteuerelemente

| Steuerelement | Was passiert, wenn es ausgewählt wird |
| --- | --- |
| **Aktualisieren** in der Vorschau | Lädt die aktuelle Vorschau neu und löscht die aktive Design Mode-Auswahl und die Rückgängig-/Wiederherstellen-Sitzung. Speichern Sie ausstehende direkte Änderungen zuerst. |
| **Beheben** / **Fehler beheben** | Sendet die angezeigte Vorschau-Diagnose an Runner als Reparaturanfrage. **Verwerfen** blendet nur die Nachricht aus. |
| **Mit KI beheben** | Schließt die Veröffentlichungsbestätigung und sendet seinen Build-Fehler an Runner zur Reparatur; die Veröffentlichung startet nicht. |
| **Prüfung erneut versuchen** | Führt die Storefront-Build-Prüfung erneut aus, nachdem Runner den Workspace nicht erreichen konnte. |
| **Store Operations öffnen** | Schließt die Veröffentlichungsbestätigung und öffnet Store Operations, damit Sie die benannte Einrichtung abschließen können. |
| **Einrichtungsstatus erneut versuchen** | Überprüft die Store Operations-Bereitschaft erneut, nachdem ihr Status nicht verfügbar war. |
| **Erneut veröffentlichen** | Startet einen neuen überprüften Veröffentlichungsversuch nach einem fehlgeschlagenen oder linkfreien Ergebnis. Beheben Sie zuerst die benannte Ursache. |
| **Checkout-Status erneut versuchen** | Überprüft erneut auf eine aktivierte Zahlungsverbindung; es testet kein Produkt, Versand oder das Checkout-Formular. |

## Zustands-zu-Aktions-Referenz

| Nachricht oder Symptom | Schicht | Was es bedeutet | Sicherste nächste Aktion |
| --- | --- | --- | --- |
| **Noch kein Storefront** | Projektversion | Es existiert keine vorschaubare Version. | Bitten Sie Runner, den ersten Storefront zu erstellen. |
| **Erste Version wird erstellt…** | Projektversion | Runner erstellt es noch. | Folgen Sie dem Task-Fortschritt; veröffentlichen Sie noch nicht. |
| **Build fehlgeschlagen** auf einer Version | Projektversion | Diese Version ist nicht bereit. | Öffnen Sie die Task-Details und bitten Sie Runner, den Fehler zu beheben. |
| **Vorschau wird vorbereitet…** | Vorschau | Runner startet die ausgewählte Vorschau. | Halten Sie die neueste Version ausgewählt; aktualisieren Sie nur, wenn der Fortschritt stoppt. |
| **Fehler beim Laden der Vorschau für diese Version** | Vorschau | Die ausgewählte Version konnte nicht angezeigt werden. | Kehren Sie zur aktuellen zurück, aktualisieren Sie oder versuchen Sie eine andere bereite Version. |
| **Vorschau wird erneut verbunden** | Vorschau | Runner hat die Vorschauverbindung verloren und versucht es erneut. | Folgen Sie der Wiederholungsanzahl; verbinden Sie den Workspace erneut, wenn die Wiederherstellung fehlschlägt. |
| Vorschau-Fehlerleiste mit **Beheben** | Vorschau | Die laufende Seite hat eine Diagnose gemeldet, die Runner verwenden kann. | Wählen Sie **Mehr anzeigen**, um sie zu überprüfen, **Beheben** oder **Fehler beheben**, um sie an Runner zu senden, oder **Verwerfen** nur, um die Leiste auszublenden. |
| **Seite nicht gefunden** | Vorschau oder öffentliche Route | Der Pfad existiert in dieser Version nicht. | Kehren Sie zu `/` zurück, verwenden Sie sichtbare Navigation und bitten Sie Runner, die Route zu erstellen oder zu reparieren. |
| **Design-Modus ist nicht gestartet** | Design-Modus | Die bearbeitbare Vorschau wurde nicht bereit. | Wählen Sie **Erneut versuchen** oder kehren Sie zur aktuellen Vorschau zurück und aktualisieren Sie. |
| **Visueller Editor deaktiviert, während KI verarbeitet wird** | Design-Modus | Runner bearbeitet eine andere Anfrage. | Warten Sie, bis Runner fertig ist. |
| **Fehler beim Laden des Versionsverlaufs** | Versionsverlauf | Die Versionslisten-Anfrage ist fehlgeschlagen. | Wählen Sie **Erneut versuchen**. |
| Wiederherstellen ist blockiert | Versionsverlauf | Runner ist aktiv oder die Version ist nicht bereit. | Warten Sie auf Runner und wählen Sie dann eine bereite Version. |
| **Wir konnten Ihren Workspace nicht erreichen** | Veröffentlichungsprüfung | Runner konnte die Build-Prüfung nicht ausführen. | Wählen Sie **Prüfung erneut versuchen**; verbinden Sie den Workspace erneut, wenn es sich wiederholt. |
| **Beim Erstellen Ihres Speichers ist etwas schief gelaufen** | Veröffentlichungsprüfung | Der aktuelle Storefront kann die Build-Prüfung nicht bestehen. | Wählen Sie **Mit KI beheben**, überprüfen Sie die Reparatur und führen Sie dann die Prüfungen erneut aus. |
| **Speichereinrichtung ist unvollständig** | Veröffentlichungseinrichtung | Wichtige Speichervorgänge bleiben unvollständig. | Wählen Sie **Store Operations öffnen**. Bestätigen Sie nur, wenn die Einschränkung beabsichtigt ist. |
| **Wir konnten Store Operations nicht überprüfen** | Veröffentlichungseinrichtung | Der Einrichtungsstatus ist unbekannt. | Wählen Sie **Einrichtungsstatus erneut versuchen**, bevor Sie eine Bestätigung in Betracht ziehen. |
| **Keine Code-Änderungen erkannt** | Veröffentlichungsänderungen | Runner hat seit der letzten Veröffentlichung nichts Neues gefunden. | Abbrechen oder eine Neubereitstellung im gleichen Zustand nur bestätigen, wenn beabsichtigt. |
| **Zahlungsintegration ist nicht konfiguriert** | Checkout-Einrichtung | Einige Veröffentlichungsflüsse zeigen dies vor dem Start, wenn keine aktivierte Zahlungsverbindung gefunden wird. | Verbinden Sie Stripe; verwenden Sie die Bestätigung nur für einen beabsichtigten reinen Browsing-Start. Andere Flüsse melden den Checkout-Status stattdessen nach der Veröffentlichung. |
| **Speicherveröffentlichung fehlgeschlagen** | Veröffentlichung | Der Versuch wurde nicht abgeschlossen. | Beheben Sie das benannte Problem und wählen Sie dann **Erneut veröffentlichen**. |
| **Speicherlink nicht verfügbar** | Veröffentlichungs-Handoff | Der Versuch wurde ohne verwendbaren öffentlichen URL-Link im Runner beendet. | Schließen Sie den Dialog, bestätigen Sie, dass der Workspace bereit ist, und wählen Sie dann **Erneut veröffentlichen**. |
| Der öffentliche Speicher zeigt alten Inhalt | Veröffentlichung oder Version | Die neuesten Projektänderungen sind nicht live. | Bestätigen Sie die neueste aktuelle Version, wählen Sie **Änderungen veröffentlichen** und öffnen Sie die öffentliche URL erneut. |
| Produkt fehlt im öffentlichen Speicher | Katalog | Die Veröffentlichung war erfolgreich, aber das beabsichtigte Produkt ist nicht sichtbar. | Überprüfen Sie Produktstatus, Markt, Preis und Bestand; veröffentlichen Sie Änderungen, falls erforderlich. |
| Warenkorbaktionen fehlen oder sind deaktiviert | Katalog oder Verfügbarkeit | Das ausgewählte Element kann derzeit nicht hinzugefügt werden. | Überprüfen Sie erforderliche Optionen, Verfügbarkeit, Bestand, Preis und Region. |
| **Checkout unterbrochen** | Zahlung | Der Post-Publish-Flow hat keine aktivierte Stripe-Verbindung gefunden. | Wählen Sie **Stripe verbinden** und testen Sie dann den tatsächlichen Checkout-Pfad erneut. |
| **Checkout-Status nicht verfügbar** | Zahlungsstatus | Runner kann die Zahlungsbereitschaft nicht bestätigen. | Wählen Sie **Checkout-Status erneut versuchen** und testen Sie den öffentlichen Checkout unabhängig. |
| Eigene benutzerdefinierte Domain zeigt eine rote Warnung und eine Tabelle **Typ / Host / Wert** | Domain | Die aktuelle Konfigurationsprüfung beim Anbieter war noch nicht erfolgreich. | Kopieren Sie die angezeigten Werte exakt zu Ihrem Anbieter. Runner prüft automatisch erneut, solange die Domain-Einstellungen geöffnet bleiben; es gibt keine manuelle Verifizierungsschaltfläche. |
| **Übertragung läuft** | Domain | Eine Domain wird zwischen Speichern verschoben. | Starten Sie keine weitere Übertragung; folgen Sie dem angezeigten Status. |

## Melden Sie ein Problem an Runner

Fügen Sie diese Details in einer Nachricht ein:

1. den genauen Seitenpfad oder die öffentliche URL;
2. ob es in der Vorschau oder im Live-Speicher fehlgeschlagen ist;
3. die aktuelle Versionsbeschriftung;
4. den genauen Fehler- oder Statustext;
5. die letzte Schaltfläche, die Sie ausgewählt haben;
6. das erwartete Ergebnis; und
7. ob sich das Problem nach der dokumentierten Wiederholungsaktion wiederholt.

Für ein visuelles Problem fügen Sie das Geräte-Layout und einen Screenshot ein. Für Checkout, stoppen Sie vor einer echten Belastung und melden Sie den letzten erfolgreichen Schritt.

## Wiederherstellungsgrenzen

- Setzen Sie einen unveränderten fehlgeschlagenen Zustand nicht wiederholt fort oder veröffentlichen Sie ihn erneut. Beheben Sie zuerst die benannte Ursache.
- Stellen Sie eine ältere Version nicht wieder her, während Runner arbeitet.
- Entfernen Sie keine Domain, um ein Storefront- oder Checkout-Problem zu beheben.
- Behaupten Sie nicht, dass der Start erfolgreich ist, bis die öffentliche URL, der beabsichtigte Katalog, der Warenkorb und der erforderliche Checkout-Schritt jeweils überprüft wurden.

## Verwandte Leitfäden

- [Vorschau Ihres Speichers](./preview-your-store)
- [Veröffentlichung vorbereiten](./prepare-to-publish)
- [Veröffentlichen und erneut veröffentlichen](./publish-and-republish)
- [Überprüfen Sie den Live-Speicher und Checkout](./live-store-and-checkout)
- [Verbinden Sie eine benutzerdefinierte Domain](./custom-domains)