Fehlerbehebung bei Vorschauen

Lösungen nach Symptom für Vorschauen, die nicht starten: Build-Fehler, Datenbankfehler und Port-Probleme.

Such dein Symptom und wende die Lösung an. Passt keines davon, hilft als Auffanglösung Analysieren & Beheben – es liest die Logs, damit du es nicht musst.

Die Vorschau startet nicht

Der Build schlägt fehl. Die Logs enden mit einem Build- oder Kompilierfehler. Das ist ein Code-Problem aus einer kürzlichen Änderung – führe Analyse & Fix aus oder antworte im zuständigen Thread.

Sie hängt bei Installation oder Build. Erste Starts sind tatsächlich langsam – Abhängigkeiten werden von Grund auf installiert. Kommt seit mehreren Minuten keine neue Log-Ausgabe, stoppe die Vorschau und starte sie neu; ein veralteter Cache oder ein vorübergehender Netzwerkfehler überlebt einen Neustart meistens nicht.

Ein Datenbankfehler beim Start (API-Vorschauen). Migrationen und Schema passen nicht zusammen – typisch direkt nach einer Änderung, die das Datenmodell bearbeitet. Analyse & Fix behebt die Abweichung; unter Vorschau-Datenbanken siehst du, wie die temporäre Datenbank vorbereitet wird.

Die Vorschau hat funktioniert, jetzt ist sie weg

Der Link ist tot / die Vorschau ist verschwunden. Vorschauen sind temporär: ungenutzte werden automatisch aufgeräumt, um Ressourcen freizugeben. Es geht nichts verloren – dein Code liegt im Repository –, also starte einfach eine frische Vorschau. Denk daran, dass die Datenbank damit zurückgesetzt wird.

Sie zeigt altes Verhalten. Wahrscheinlich siehst du dir einen anderen Branch oder Thread-Workspace an, als du denkst. Prüfe im Preview Hub, aus welcher Quelle die Vorschau gestartet wurde; die Änderungen eines Threads erscheinen in seiner Vorschau, nicht in einer, die aus deinem Standard-Branch gebaut wurde.

Sie startet, verhält sich aber falsch

Leere Seite oder endloser Ladekreis. Öffne die Logs und beobachte sie, während du die Seite neu lädst – ein Laufzeitfehler erscheint genau in diesem Moment. Gib ihn an Analyse & Fix weiter.

Falsche oder fehlende Daten. Vorschauen laufen mit Beispieldaten, nicht mit deinen Produktionsdatensätzen. Ein leerer Bildschirm kann einfach bedeuten, dass die Beispieldaten diesen Fall nicht abdecken – bitte die KI, sie zu erweitern.

Funktioniert am Desktop, auf dem Handy kaputt. Echte Layout-Fehler; melde sie mit Screenshots oder Markierungen. Siehe Auf dem Handy testen.

Eine neue Vorschau startet gar nicht

Vielleicht hast du das Limit deines Workspace für gleichzeitig laufende Vorschauen erreicht. Stoppe im Preview Hub eine, die du nicht mehr brauchst, und starte die neue. Die Limits richten sich nach deinem Plan – siehe Preise.

Die API-Vorschau erreicht die Datenbank nicht

Die Logs erwähnen localhost:5432, „connection refused“ oder „database does not exist“. Die API zielt noch auf ein lokales Postgres auf der Maschine statt auf die Vorschau-Datenbank, die EvonX gestartet hat. Starte die Vorschau neu, damit die Umgebungsvariablen erneut eingespielt werden. Passiert es nach einer Code-Änderung immer wieder, nutze Analysieren & Beheben – das ist der übliche Weg, wenn die App den eingespielten Connection-String ignoriert.

Die App startet und stürzt dann wegen einer fehlenden Tabelle ab (zum Beispiel ein Seed-Schritt, der von einer Relation spricht, die nicht existiert). Migrationen und Modell sind auseinandergelaufen. Analyse & Fix, oder bitte einen Thread, das Schema an das anzupassen, was der Start erwartet. Siehe Vorschau-Datenbanken.