Fehlerbehandlung und -behebung

Zu verstehen, wie Sie Fehler interpretieren, darauf reagieren und sie melden, hilft Ihnen, produktive Entwicklungssitzungen mit Verdent for VS Code aufrechtzuerhalten.

Das lernen Sie

Häufige Fehlertypen und ihre Ursachen
Wie Sie Fehlermeldungen effektiv interpretieren
Systematische Schritte zur Fehlerbehebung
Wann Sie warten und wann Sie handeln sollten
Wie Sie Probleme an das Verdent-Team melden

Eine umfassende Fehlerdokumentation wird derzeit erstellt. Die folgenden Informationen decken die am häufigsten auftretenden Fehlerkategorien ab. Bei spezifischen Fehlerszenarien wenden Sie sich an support@verdent.ai oder besuchen Sie die Discord-Community.

Überlastete Server

Tritt bei hoher Auslastung auf
Vorübergehende Kapazitätsengpässe
Maßnahme: 5–10 Minuten warten und erneut versuchen

Interne Serverfehler

Probleme bei der Backend-Verarbeitung
Vorübergehende Dienststörungen
Maßnahme: Warten und erneut versuchen, löst sich meist automatisch auf

503 Service Unavailable

Keine funktionsfähigen Upstream-Server
Vorübergehende Infrastrukturprobleme
Maßnahme: Auf Wiederherstellung des Dienstes warten

Rate-Limiting-Fehler

Anfragekontingent überschritten
Drosselungsschutz von API
Maßnahme: Auf Rücksetzung des Rate-Limits warten, Anfragehäufigkeit reduzieren

Ungültige oder abgelaufene Anmeldedaten
Probleme mit Sitzungs-Timeout
Maßnahme: Über das User Center erneut authentifizieren, aktives Abonnement überprüfen

Netzwerkverbindungsprobleme
Firewall oder VPN blockiert Verbindungen
Einschränkungen im Unternehmensnetzwerk
Maßnahme: Netzwerkverbindung prüfen, anderes Netzwerk ausprobieren

Ungültige Einstellungen oder Präferenzen
Beschädigte Konfigurationsdateien
Maßnahme: Zuletzt vorgenommene Einstellungsänderungen prüfen, Konfiguration überprüfen

Unzureichende Dateisystemberechtigungen
Einschränkungen beim Zugriff auf den Arbeitsbereich
Maßnahme: Datei-/Ordnerberechtigungen prüfen, Zugriff auf den Arbeitsbereich überprüfen

Fehlermeldungen interpretieren

Ein detaillierter Leitfaden zur Interpretation von Fehlermeldungen befindet sich in Entwicklung. Nutzen Sie für konkrete Fehlermeldungen, auf die Sie stoßen, die Feedback-Schaltfläche oder die Discord-Community um Unterstützung.

Serverseitige Fehler sind vorübergehend und lösen sich meist durch Warten. Außer erneutem Versuchen nach ein paar Minuten ist keine weitere Maßnahme erforderlich.

Achten Sie auf diese Schlüsselwörter:

„Overloaded“ oder „at capacity“
„Internal server error“ oder „backend processing“
„503 Service Unavailable“ oder „no healthy upstream“
„Rate limit“ oder „quota“

Was zu tun ist:

5–10 Minuten warten, bevor Sie es erneut versuchen
Mit der lokalen Entwicklungsarbeit fortfahren
Bisher vorgenommene Codeänderungen überprüfen
Aktuelle Arbeit in Git committen

Allgemeine Regel: Wenn die Fehlermeldung Serverstatus, Kapazität oder Rate-Limits erwähnt, ist sie vorübergehend. Es handelt sich um Infrastrukturprobleme, die sich automatisch lösen.

Vorübergehende Serverfehler (502, 503, 504) lösen sich meist innerhalb von Minuten. Warten Sie 2–3 Minuten, bevor Sie es erneut versuchen.

Wann eskalieren:

Fehler besteht länger als 15 Minuten
Discord auf Berichte zu Ausfällen prüfen
Nach Aktualisierungen auf der Statusseite suchen

Clientseitige Fehler erfordern eine Maßnahme Ihrerseits. Diese lösen sich nicht durch Warten.

Achten Sie auf diese Hinweise:

Meldungen im Zusammenhang mit Authentifizierung oder Anmeldedaten
Konfigurations- oder Einstellungsfehler
Dateiberechtigungsfehler
Fehlgeschlagene Netzwerkverbindungen

Was zu tun ist:

Authentifizierungsfehler: Über das User Center erneut authentifizieren, aktives Abonnement überprüfen
Konfigurationsfehler: Zuletzt vorgenommene Einstellungsänderungen prüfen, Konfigurationsdateien überprüfen
Berechtigungsfehler: Datei-/Ordnerberechtigungen prüfen, Zugriff auf den Arbeitsbereich überprüfen
Netzwerkfehler: Internetverbindung testen, anderes Netzwerk ausprobieren, VPN/Firewall prüfen

Allgemeine Regel: Wenn der Fehler Authentifizierung, Konfiguration, Berechtigungen oder lokale Einstellungen erwähnt, müssen Sie korrigierend eingreifen.

Schritte zur Fehlerbehebung:

Vollständige Fehlermeldung auf konkrete Hinweise lesen
Feststellen, welche Komponente den Fehler gemeldet hat (Authentifizierung, Konfiguration, Berechtigungen, Netzwerk)
Gezielte Maßnahme je nach Fehlertyp ergreifen
Behebung durch erneuten Versuch der ursprünglichen Aktion überprüfen

Fehlerkontext verstehen

Wenn Fehler auftreten:

Vollständige Fehlermeldung lesen – Details nicht überspringen
Fehlercodes beachten – Konkrete Codes helfen bei der Diagnose
Komponente identifizieren – Welches System hat den Fehler gemeldet (Server, API, lokal)
Zeitpunkt prüfen – Ist der Fehler sofort oder mit Verzögerung aufgetreten?

Systematische Fehlerbehebung

Führen Sie diese schrittweisen Maßnahmen aus, wenn sich Verdent unerwartet verhält, beginnend mit den am wenigsten störenden Aktionen.

Erste Reaktion

Abwarten und beobachten

Prüfen Sie, ob das Verhalten durchgängig oder unregelmäßig auftritt. Notieren Sie, welche Aktion das unerwartete Verhalten ausgelöst hat. Gehen Sie nicht sofort davon aus, dass etwas defekt ist – viele Probleme sind vorübergehend.

Einfacher Neustart

Starten Sie Verdent for VS Code neu (schließen und erneut öffnen Sie VS Code). Das behebt oft blockierte Zustände oder Leistungsprobleme. Dies ist der einfachste erste Schritt zur Fehlerbehebung.

Schrittweise Fehlerbehebung

Wenn ein einfacher Neustart das Problem nicht löst:

Führen Sie die systematischen Schritte zur Fehlerbehebung in der richtigen Reihenfolge aus – wenn Sie Schritte überspringen, verpassen Sie oft die eigentliche Ursache.

Netzwerkverbindung prüfen

Testen Sie die Internetverbindung mit anderen Websites. Probieren Sie ein anderes Netzwerk (mobiler Hotspot), um Firewall-/VPN-Probleme auszuschließen. Prüfen Sie, ob das Unternehmensnetzwerk Verbindungen blockiert.

Konfiguration überprüfen

Prüfen Sie, ob Sie noch authentifiziert sind. Überprüfen Sie im User Center, ob das Abonnement aktiv ist. Prüfen Sie zuletzt vorgenommene Einstellungsänderungen, die das Verhalten beeinflussen könnten.

Hilfe suchen

Prüfen Sie die Discord-Community auf ähnliche Berichte: https://discord.com/invite/NGjXEZcbJq. Nutzen Sie die Feedback-Schaltfläche, um das Problem zu melden. Fügen Sie eine Beschreibung des unerwarteten Verhaltens und Schritte zur Reproduktion hinzu.

Was Sie NICHT tun sollten

Vermeiden Sie diese Maßnahmen bei vorübergehenden Problemen:

Verdent nicht sofort neu installieren
Cache oder Anwendungsdaten von VS Code nicht löschen
Systemeinstellungen bei vorübergehenden Problemen nicht ändern
Computer nicht neu starten, außer wenn auch andere Anwendungen betroffen sind

Genehmigen Sie in Manual Accept Mode niemals destruktive Vorgänge (rm, DROP, DELETE), ohne den genauen Befehl sorgfältig zu prüfen.

Warum? Diese Maßnahmen sind zeitaufwendig und lösen Probleme selten. Die meisten Probleme lösen sich durch einen einfachen Neustart oder das Abwarten vorübergehender Serverprobleme.

Wann warten und wann handeln

Zu verstehen, ob Sie warten oder handeln sollten, verhindert unnötigen Aufwand bei der Fehlerbehebung.

Diese Fehler lösen sich automatisch – außer Warten und erneutem Versuchen ist keine Maßnahme erforderlich.

Serverüberlastung oder Kapazitätsfehler:

Meldungen wie „Overloaded“ oder „at capacity“
Zeiten hoher Auslastung
Vorübergehende Dienststörungen

Rate-Limiting:

Meldungen wie „Rate limit“ oder „quota exceeded“
Zu viele Anfragen in kurzer Zeit
Drosselungsschutz von API

Zeitweise Verbindungsprobleme:

Gelegentlich fehlgeschlagene Anfragen, die beim erneuten Versuch erfolgreich sind
Netzwerkaussetzer
Kurze Verbindungsabbrüche

Was Sie während des Wartens tun können:

Mit der lokalen Entwicklungsarbeit fortfahren
Bisher vorgenommene Codeänderungen überprüfen
Nächste Schritte oder Aufgaben planen
Aktuelle Arbeit in Git committen

Wie lange warten:

Standardwartezeit: 5–10 Minuten
Wenn der Fehler nach 10 Minuten weiterhin auftritt, zur Fehlerbehebung übergehen
Discord auf Berichte über weit verbreitete Probleme prüfen

Diese Fehler lösen sich nicht durch Warten – Sie müssen korrigierend eingreifen.

Authentifizierungsfehler:

Sitzung abgelaufen → Über das User Center erneut authentifizieren
Ungültige Anmeldedaten → Aktives Abonnement überprüfen
Erneute Authentifizierung erforderlich → User Center prüfen

Anhaltende Fehler (10+ Minuten):

Derselbe Fehler wiederholt nach mehreren Versuchen → Fehlerbehebung starten
Konsistentes Fehlermuster → Konfiguration prüfen
Fehler besteht über mehrere Neustarts hinweg → Umgebung überprüfen

Konfigurationsprobleme:

Einstellungen kürzlich geändert → Änderungen prüfen und zurücksetzen
Neue Einrichtung oder Installation → Konfigurationsdateien überprüfen
Netzwerkumgebung geändert → Konnektivität testen

Berechtigungsfehler:

Zugriff auf Dateisystem verweigert → Datei-/Ordnerberechtigungen prüfen
Einschränkungen beim Arbeitsbereich → Zugriff auf den Arbeitsbereich überprüfen
Ordnerberechtigungen → Erforderliche Berechtigungen gewähren

Netzwerkprobleme:

Vollständige Verbindungsunfähigkeit → Internetverbindung testen
VPN oder Firewall blockiert → Anderes Netzwerk ausprobieren
Einschränkungen im Unternehmensnetzwerk → IT-Support kontaktieren

Entscheidungsregel:

Server-/Rate-Fehler → Warten
Authentifizierung/Konfiguration/Berechtigung/Netzwerk → Sofort handeln
Unsicher? → Zuerst 5–10 Minuten warten, dann handeln, falls das Problem weiterhin besteht

Fehlerkontext bereitstellen

Wenn Sie um Hilfe bitten oder Probleme melden, geben Sie umfassenden Kontext für eine schnellere Diagnose an.

Wesentliche Informationen

Fehlerdetails:

Exakter Text der Fehlermeldung (kopieren, nicht umformulieren)
Fehlercode, falls vorhanden
Zeitstempel des Auftretens
Häufigkeit (einmalig, unregelmäßig, durchgängig)

Umgebung:

Version von Verdent for VS Code
Version von VS Code
Betriebssystem und Version
Netzwerkumgebung (privat, Unternehmen, VPN)

Schritte zur Reproduktion:

Was Sie tun wollten
Verwendete exakte Prompts oder Befehle
Beteiligte Dateien oder Kontext
Vor dem Fehler durchgeführte Aktionen

Kontext:

Welchen Ausführungsmodus Sie verwendet haben
Größe und Komplexität des Arbeitsbereichs
Kürzlich vorgenommene Konfigurationsänderungen
Frühere erfolgreiche, ähnliche Vorgänge

Beispiel für einen Fehlerbericht

Gutes Format für einen Fehlerbericht:

Issue: Getting "Internal server error" when requesting code analysis

Error Message (exact):
"Error: Internal server error occurred during processing. Please try again later."

Environment:
- Verdent for VS Code v1.2.3
- VS Code 1.85.0
- macOS 14.2
- Home network (no VPN)

Steps to Reproduce:
1. Opened large TypeScript project (500+ files)
2. Used Auto-Run Mode
3. Requested: "Analyze authentication flow in auth.ts and suggest improvements"
4. Error occurred immediately after request

Additional Context:
- First time working with this project
- Same request worked fine yesterday in different project
- Other requests (small file edits) work normally

Was diesen Bericht wirksam macht

Exakter Text der Fehlermeldung
Vollständige Umgebungsdetails
Klare Schritte zur Reproduktion
Vergleich mit funktionierenden Szenarien
Zusätzlicher Kontext zu Mustern

Probleme melden

Ort: Obere Leiste des Verdent-Panels

Was sie macht:

Öffnet ein Popup-Overlay zum Einreichen von Problemen und Vorschlägen
Direkter Kanal zum Verdent-Team
Am besten geeignet für Fehlerberichte und Funktionswünsche

Wann verwenden:

Bestätigte Fehler mit klaren Schritten zur Reproduktion
Funktionswünsche mit konkreten Anwendungsfällen
Direkte Kommunikation mit dem Team erforderlich
Nicht dringende Probleme, die eine Untersuchung erfordern

Was einzuschließen ist:

Klare Beschreibung des Problems
Fehlermeldungen (exakter Text)
Schritte zur Reproduktion
Erwartetes vs. tatsächliches Verhalten
Version von Verdent und Plattform
Wann das Problem begann

Link: https://discord.com/invite/NGjXEZcbJq

Was sie bietet:

Aktive Community aus Verdent-Nutzern und Teammitgliedern
Unterstützung bei der Fehlerbehebung in Echtzeit
Probleme mit Screenshots teilen
Hilfe von erfahrenen Nutzern erhalten
Community-Diskussionen und Workarounds

Wann verwenden:

Dringende Probleme, die eine sofortige Diskussion erfordern
Komplexe Fehlerbehebung, die Hin und Her erfordert
Community-Input zu Best Practices
Kurze Fragen vor dem Einreichen formaler Berichte
Workarounds mit der Community teilen

Problemtyp	Feedback-Schaltfläche verwenden	Discord verwenden
Bestätigter Fehler mit Schritten zur Reproduktion	✓
Funktionswunsch	✓
Dringende Fehlerbehebung erforderlich		✓
Komplexes Problem, das Diskussion erfordert		✓
Kurze Frage		✓
Community-Input gewünscht		✓
Formaler Fehlerbericht	✓
Allgemeine Hilfe		✓

Was NICHT gemeldet werden sollte:

Vorübergehende Serverfehler (< 10 Minuten)
Zeiten hoher Auslastung
Bereits dokumentierte Probleme
Erwartetes Verhalten

Stattdessen: Bei vorübergehenden Problemen warten, Discord auf aktuelle Berichte prüfen, Dokumentation durchsehen.

Best Practices zur Vorbeugung

Proaktive Praktiken reduzieren die Fehlerhäufigkeit und verbessern die Wiederherstellung, wenn Fehler auftreten.

Verwenden Sie präzise Sprache in Prompts und fügen Sie relevanten Dateikontext hinzu, um viele häufige Fehler von vornherein zu vermeiden.

Vor Beginn der Arbeit

1. Einrichtung überprüfen

Authentifizierungsstatus im User Center prüfen
Bestätigen, dass das Abonnement aktiv ist
Stabile Netzwerkverbindung sicherstellen
Kürzlich vorgenommene Konfigurationsänderungen überprüfen

2. Git initialisieren

Vor der Nutzung freizügiger Modi immer Versionskontrolle einrichten
Aktuelle Arbeit für einen sauberen Ausgangspunkt committen
Bietet eine Rollback-Option, falls Probleme auftreten

3. Credit-Guthaben prüfen

Ausreichende Credits für die geplante Arbeit sicherstellen
Bei Bedarf vor komplexen Aufgaben aufladen
Unterbrechungen mitten in der Aufgabe durch aufgebrauchte Credits vermeiden

Während der Entwicklung

1. Passende Ausführungsmodi verwenden

Manuelle Bestätigung bei unbekanntem Code
Plan Mode für komplexe Änderungen
Auto-Run nur mit dem Sicherheitsnetz von Git
Modus an das Risikoniveau anpassen

2. Leistung überwachen

Auf nachlassende Antwortqualität achten
Langsamere Antwortzeiten beachten
Neue Sitzungen starten, wenn die Leistung nachlässt
Kontextnutzung manuell verfolgen

3. Klare, präzise Prompts

Fehler durch missverstandene Anfragen reduzieren
Relevanten Kontext und Einschränkungen einbeziehen
Auf bestehende Muster verweisen
Umfang klar angeben

Nach Fehlern

1. Aus Mustern lernen

Notieren, was Fehler ausgelöst hat
Reproduzierbare Bedingungen identifizieren
Workflow anpassen, um Auslöser zu vermeiden
Erkenntnisse mit der Community teilen

2. Workarounds dokumentieren

Notizen zu wirksamen Lösungen führen
Mit Teammitgliedern teilen
Zum Community-Wissen beitragen
Dem Verdent-Team für Fixes melden

3. Konfiguration aktualisieren

Einstellungen anhand von Erfahrungen anpassen
Für Ihren Workflow optimieren
Regeln konfigurieren, um Probleme zu vermeiden
AGENTS.md-Dokumentation pflegen