Fehler beheben und Logs lesen
App startet nicht, Teil abgestürzt, Server ausgelastet, Build fehlgeschlagen: Ursachen finden und mit oder ohne KI beheben.
Fehler gehören zum Bauen. Agile Vibes zeigt sie Ihnen früh und bietet fast überall Mit KI beheben an.
Wo Fehler auftauchen
- Fehlerleiste in der Vorschau: Konsolenfehler, Laufzeitfehler, Build-Fehler und fehlgeschlagene Netzwerk-Aufrufe Ihrer App. Ein Klick auf die Leiste zeigt alle Fehler mit Art und Anzahl. Ein roter Punkt am Tab Vorschau (bzw. unten in der Handy-Leiste) zeigt offene Fehler.
- Tab Logs: die Ausgabe jedes Teils (Frontend, Backend) live.
- Chat: fehlgeschlagene KI-Läufe mit roter Meldung.
- Veröffentlichen: fehlgeschlagener Build mit Protokoll.
- Import: fehlgeschlagener Start mit Logs.
Mit KI beheben
- In der Fehlerleiste der Vorschau auf Mit KI beheben klicken.
- Die KI bekommt die gesammelten Fehler als Nachricht („Bitte behebe diese Fehler aus der Vorschau …“), liest Logs und Code und repariert.
- Danach prüft sie ihre Änderung selbst und repariert bei Bedarf nach. Diese Reparaturschritte werden wie jede andere Antwort berechnet; den Betrag sehen Sie im Chat.
Mit dem Kreuz blenden Sie die Fehlerleiste aus, ohne etwas zu ändern.
Logs lesen
Editor › Tab Logs:
- Bei mehreren Teilen wählen Sie oben den Teil.
- Der Status-Punkt zeigt, ob der Teil läuft oder abgestürzt ist.
- Filtern …: nur Zeilen mit einem Suchwort.
- Nur Fehler (Warn-Symbol): nur Fehlerausgabe.
- Folgen: springt automatisch zu neuen Zeilen; beim Hochscrollen hält es an.
- Kopieren: die sichtbaren Zeilen in die Zwischenablage, zum Beispiel für eine Nachricht an die KI.
- Ansicht leeren: nur die Anzeige, nicht die Logs.
- Neu starten (Pfeil-Kreis): startet den Teil neu.
Lesetipps: Fehlermeldungen stehen meist unten. Suchen Sie nach „Error“, „Traceback“, „Cannot find module“, „EADDRINUSE“ oder „ECONNREFUSED“. Die erste Fehlermeldung ist oft die Ursache, die folgenden sind Folgen.
Häufige Probleme und Lösungen
„App startet …“ bleibt lange stehen
- Beim ersten Start oder nach einer Pause fährt die Sandbox hoch. Das dauert ein paar Sekunden, nach einem Import mit Installation auch länger.
- Prüfen Sie im Tab Logs, ob der Teil startet oder mit einem Fehler endet.
- Hilft das nicht: Neu laden in der Vorschau.
Die App startet nicht
Typische Ursachen:
- Fehlendes Paket („Cannot find module“, „ModuleNotFoundError“): Bitten Sie die KI, das Paket zu installieren.
- Fehlende Variable oder Geheimnis: Die Logs nennen den Namen. Tragen Sie ihn unter Einstellungen › Geheimnisse bzw. Teile ein. Siehe Variablen, Geheimnisse und Platzhalter.
- Falscher Startbefehl oder Port: Unter Einstellungen › Teile prüfen. Der Startbefehl muss den Port aus {{port}} verwenden und auf 0.0.0.0 lauschen.
- Datenbank-Fehler (etwa Tabelle fehlt): siehe Python-Backends und Datenbanken.
Am schnellsten: Schreiben Sie „Die App startet nicht, bitte prüfe die Logs und repariere den Start“.
Ein Teil ist abgestürzt
Der Status-Punkt im Tab Logs zeigt einen Fehler. Agile Vibes startet abgestürzte Teile mit wachsendem Abstand selbst neu. Endet der Teil immer wieder, liegt ein Fehler im Code oder in der Konfiguration vor. Lesen Sie die letzten Zeilen, nutzen Sie Kopieren und geben Sie sie der KI, oder klicken Sie nach der Korrektur auf Neu starten.
„Server ausgelastet“
Meldung: „Der Sandbox-Server ist gerade ausgelastet. Bitte versuchen Sie es in einer Minute erneut.“ bzw. die Seite „Gerade ausgelastet“. Sandboxen teilen sich einen Server; ist er voll, kann gerade keine weitere starten. Ungenutzte Sandboxen werden automatisch beendet. Warten Sie kurz; die Warteseite versucht es selbst weiter. Ihre Daten sind davon nicht betroffen, und veröffentlichte Apps laufen in eigenen Containern weiter.
„Vorschau nicht erreichbar“
Der Zugang zur Vorschau konnte nicht geholt werden. Klicken Sie auf Erneut versuchen. Die Vorschau ist nur für angemeldete Mitglieder Ihres Teams sichtbar, sofern sie nicht öffentlich geschaltet ist.
Der Build beim Veröffentlichen ist fehlgeschlagen
Die bisherige Version bleibt online. Im Dialog Protokoll anzeigen und Mit KI beheben wählen. Häufig: Typfehler, die im Entwicklungsmodus nicht auffallen, oder fehlende Variablen beim Build.
Der KI-Lauf ist fehlgeschlagen
Die Antwort zeigt „Der Lauf ist fehlgeschlagen. Nicht verbrauchtes Guthaben wird erstattet.“ Senden Sie die Nachricht erneut. Hat die KI bereits Änderungen gemacht, die Sie nicht möchten, stellen Sie im Tab Versionen den Stand davor wieder her.
Netzwerk-Fehler im Frontend
Die Fehlerleiste zeigt „Netzwerk“ mit der Adresse. Prüfen Sie, ob das Backend läuft (Tab Logs) und ob die Backend-Adresse über einen Platzhalter gesetzt ist.
Tipps
- Nach jeder KI-Änderung kurz die Vorschau prüfen, dann bleiben Fehler klein.
- Wenn eine Reparatur im Kreis läuft: Version vor dem Fehler wiederherstellen und die Aufgabe kleiner formulieren, oder KI-Modus Gründlich wählen.
- Fehler aus dem Browser Ihrer Nutzer (veröffentlichte App) sehen Sie nicht in der Vorschau. Beschreiben Sie sie der KI mit Schritten zum Nachstellen.
Häufige Fragen
Kostet „Mit KI beheben“ Guthaben?
Ja, wie jede KI-Antwort, auch automatische Reparaturen der KI an ihren eigenen Änderungen. Läufe, die an unserer Seite scheitern, kosten nichts.
Kann ich einen Teil selbst neu starten?
Ja, im Tab Logs mit dem Neustart-Knopf.