XAIO
Docs/Help/Fehlerbehebung

Fehlerbehebung

Aktualisiert 29. März 2026Help

Lösungen für häufige Probleme.

Vorschau zeigt eine leere Seite

  • Warte ein paar Sekunden — der Vorschau-Server startet eventuell noch
  • Prüfe, ob die Browser-Konsole Fehler zeigt (Rechtsklick > Untersuchen > Konsole)
  • Frag die KI: „Die Vorschau ist leer, kannst du nach Fehlern schauen?"
  • Versuch den Aktualisieren-Button in der Vorschau-Toolbar

Vorschau zeigt einen Fehler

  • Sag der KI: „Die Vorschau zeigt diesen Fehler: [Fehler einfügen]"
  • Die KI kann Fehler-Logs lesen und das Problem automatisch beheben
  • Bleibt der Fehler bestehen, versuch: „Bitte starte das Frontend neu"

Änderungen erscheinen nicht in der Vorschau

  • Die Vorschau nutzt Hot Module Replacement (HMR) — Änderungen sollten sofort erscheinen
  • Falls nicht, klick den Aktualisieren-Button in der Vorschau-Toolbar
  • Bei Backend-Änderungen muss das Backend evtl. neu starten: „Bitte starte das Backend neu"

Meldung „AI service error"

  • meist vorübergehend. Sende deine Nachricht erneut
  • bleibt es bestehen, lade die Seite neu
  • prüfe in der Sidebar, ob du noch AI Tasks übrig hast

AI Tasks aufgebraucht

  • dein aktueller Plan hat eine begrenzte Anzahl AI Tasks pro Monat
  • upgrade deinen Plan oder kaufe zusätzliche AI-Task-Pakete in den Einstellungen
  • die Sidebar zeigt deine verbleibenden AI Tasks

Veröffentlichte Seite zeigt eine leere Seite

  • veröffentliche das Projekt erneut
  • prüfe die Browser-Konsole auf JavaScript-Fehler
  • stelle sicher, dass alle Routen korrekt konfiguriert sind (lass die KI prüfen)

GitHub-Sync funktioniert nicht

  • prüfe, ob dein GitHub-Konto in den Einstellungen noch verbunden ist
  • stelle sicher, dass das Repository existiert und du Schreibzugriff hast
  • versuch, GitHub zu trennen und neu zu verbinden

Datenbankverbindung schlägt fehl

  • prüfe, ob PostgreSQL im Integrationen-Tab aktiviert ist
  • Umgebungsvariablen werden automatisch injiziert — setze DATABASE_URL nicht manuell
  • bei veröffentlichten Seiten prüfe, ob die Prod-Datenbank bereitgestellt wurde

Upload schlägt fehl

  • prüfe die Dateigröße: maximal 10 MB pro Datei
  • unterstützte Bildformate: JPG, PNG, GIF, WebP, SVG
  • unterstützte Dokumente: PDF, DOCX, XLSX, PPTX

Die KI macht ungewollte Änderungen

  • sei in deinen Anfragen konkreter: sag genau, welche Datei oder welcher Abschnitt geändert werden soll
  • nutze den Design-Mode, um das exakte Element auszuwählen
  • ging eine Änderung schief: „Mach die letzte Änderung rückgängig" oder „Stell die vorherige Version wieder her"

Workspace ist langsam oder reagiert nicht

  • schließe andere Browser-Tabs, um Speicher freizugeben
  • versuch, die Seite neu zu laden
  • ist der Workspace-Container abgestürzt, startet er innerhalb einer Minute automatisch neu