Fehlerbehebung bei Vorschau und Veröffentlichung

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

Überprüfen Sie in Storefront, ob eine aktuelle Version vorhanden ist.
Bestätigen Sie, ob die normale Vorschau geöffnet wird.
Wenn Sie veröffentlichen, lesen Sie das Ergebnis der Build-Prüfung, bevor Sie eine andere Aktion auswählen.
Wenn die Veröffentlichung erfolgreich ist, öffnen Sie die öffentliche URL statt der Vorschau-URL.
Testen Sie im öffentlichen Speicher den Katalog und den Warenkorb.
Überprüfen Sie den Checkout-Status von Runner und den tatsächlichen Checkout-Pfad.
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.
Benutzerdefinierte Domain sagt Falsch konfiguriert	Domain	Erwartete DNS-Einträge sind nicht überprüft.	Kopieren Sie die angezeigten DNS-Werte genau zu Ihrem Anbieter und überprüfen Sie dann erneut.
Ü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:

den genauen Seitenpfad oder die öffentliche URL;
ob es in der Vorschau oder im Live-Speicher fehlgeschlagen ist;
die aktuelle Versionsbeschriftung;
den genauen Fehler- oder Statustext;
die letzte Schaltfläche, die Sie ausgewählt haben;
das erwartete Ergebnis; und
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.