Fehler finden & beheben
title: Fehler finden & beheben: Setup/Installation description: Diagnose für typische Setup- und Installationsprobleme in Traumkunden.ai: Ursachen prüfen, Fehler eingrenzen und Support vorbereiten.
Setup- und Installationsprobleme eingrenzen
Wenn ein Setup scheitert, hilft zuerst eine saubere Diagnose. Die folgenden Schritte zeigen dir, wie du die Ursache eingrenzt, typische Fehlerbilder erkennst und die richtigen Informationen für den Support vorbereitest.
Halte diese drei Punkte fest, bevor du etwas änderst:
- Reproduzierbarer Fehler — Welche Aktion löst das Problem zuverlässig aus?
- Exakte Fehlermeldung — Kopiere die Meldung vollständig, ohne sie zusammenzufassen.
- Zeitpunkt und Umgebung — Wann trat der Fehler auf, und in welcher Umgebung oder Version?
Schnellcheck
Konfiguration und Verbindungen prüfen
Prüfe zuerst, ob die grundlegenden Einstellungen vollständig sind und ob die betroffenen Systeme miteinander verbunden sind. Fehlende Verknüpfungen oder eine unvollständige Konfiguration sind die häufigste Ursache für Setup-Fehler.
Berechtigungen und Zugriff prüfen
Stelle sicher, dass der verwendete Zugriff gültig ist und die nötigen Rechte vorhanden sind. Wenn ein Token abgelaufen, deaktiviert oder zu eingeschränkt ist, schlägt der Vorgang meist früh fehl.
Eingabedaten prüfen
Vergleiche die erwarteten Pflichtfelder mit den tatsächlich übergebenen Daten. Ein fehlender Wert, ein leerer Eintrag oder ein falsch benanntes Feld reicht oft aus, damit die Einrichtung abbricht.
Letzte Änderung prüfen
Überlege, was seit dem letzten erfolgreichen Lauf geändert wurde. Wenn ein neuer Wert, eine geänderte Einstellung oder ein Update den Fehler ausgelöst haben könnte, teste die vorherige Konfiguration erneut oder nimm die letzte Änderung zurück.
Erneut ausführen und Ausgaben prüfen
Starte den Vorgang erneut und lies die Ausgabe oder die Logs vollständig durch. Oft steckt der eigentliche Hinweis nicht in der ersten Fehlermeldung, sondern in einer Zeile davor oder danach.
Häufige Fehlerbilder
Typische Symptome
- Der Zugriff wird direkt verweigert.
- Ein Schritt bricht ohne weitere Verarbeitung ab.
- Die Umgebung meldet fehlende Rechte oder einen ungültigen Zugang.
Wahrscheinliche Ursachen
- Der Zugang ist abgelaufen, deaktiviert oder falsch hinterlegt.
- Die Rolle hat nicht die nötigen Rechte für den Vorgang.
- Ein Dienstkonto oder Token wird in der falschen Umgebung verwendet.
Nächste Schritte
- Prüfe, ob der Zugang noch gültig ist.
- Vergleiche die Berechtigungen mit einer funktionierenden Umgebung.
- Ersetze testweise den Zugang durch einen bekannten gültigen Wert.
Typische Symptome
- Der Setup-Prozess bleibt an einer Konfigurationsprüfung hängen.
- Einzelne Werte werden als leer oder unbekannt erkannt.
- Die Installation startet, endet aber ohne vollständige Einrichtung.
Wahrscheinliche Ursachen
- Pflichtangaben fehlen.
- Eine Verknüpfung oder Zuordnung wurde nicht gesetzt.
- Eine Umgebungsvariable oder Einstellung ist nicht verfügbar.
Nächste Schritte
- Vergleiche deine Einstellungen mit der erwarteten Grundkonfiguration.
- Prüfe, ob alle Pflichtfelder vorhanden sind.
- Setze die fehlende Konfiguration nach und teste den Ablauf erneut.
Typische Symptome
- Der Vorgang bricht bei der Eingabe oder beim Import ab.
- Eine Validierung meldet ungültige oder unvollständige Daten.
- Ein Feld wird zwar übergeben, aber nicht akzeptiert.
Wahrscheinliche Ursachen
- Ein Pflichtfeld fehlt.
- Ein Wert hat das falsche Format.
- Ein Feldname stimmt nicht mit dem erwarteten Schema überein.
Nächste Schritte
- Vergleiche die Eingabedaten Feld für Feld mit der erwarteten Struktur.
- Korrigiere leere oder fehlerhafte Werte.
- Teste die kleinste gültige Datenmenge und erweitere sie danach schrittweise.
Typische Symptome
- Die Verbindung dauert ungewöhnlich lange.
- Der Vorgang endet mit einem Zeitüberschreitungsfehler.
- Ein externer Dienst reagiert nicht oder ist nicht erreichbar.
Wahrscheinliche Ursachen
- Ein Zielsystem ist vorübergehend nicht erreichbar.
- Eine Verbindung wird von Firewall, Proxy oder Netzwerkrichtlinie blockiert.
- Die Antwort dauert länger als erwartet.
Nächste Schritte
- Prüfe, ob das Zielsystem grundsätzlich erreichbar ist.
- Teste die Verbindung aus derselben Umgebung erneut.
- Wiederhole den Vorgang nach kurzer Zeit, wenn ein externer Dienst beteiligt ist.
Typische Symptome
- Die Meldung ist allgemein und liefert keine klare Ursache.
- Der Fehler tritt nur unter bestimmten Bedingungen auf.
- Mehrere Versuche führen zum gleichen Abbruch.
Wahrscheinliche Ursachen
- Mehrere kleine Probleme treten gleichzeitig auf.
- Eine vorherige Änderung hat einen Nebeneffekt ausgelöst.
- Die Ausgabe enthält mehr Details, als die erste Fehlermeldung zeigt.
Nächste Schritte
- Lies die Logs vollständig und suche nach der ersten auffälligen Abweichung.
- Setze die letzte Änderung testweise zurück.
- Reduziere den Ablauf auf einen minimalen Reproduktionsfall.
Wenn du Support brauchst
Sende diese Informationen mit, damit Support schneller eingrenzen kann, was schiefgelaufen ist:
- Reproduktionsschritte — Was hast du genau gemacht?
- Exakte Fehlermeldung — Vollständig und unverändert.
- Zeitpunkt des Fehlers — Möglichst mit Zeitzone.
- Umgebung — Zum Beispiel Test, Staging oder Produktion.
- Letzte Änderung — Was wurde kurz vor dem Fehler angepasst?
- Relevante Logs oder Ausgaben — Die Stelle rund um den Fehler, nicht nur die letzte Zeile.