Fehlerbehebung mit KI
Auf dieser Seite
Fehler schneller finden und beheben
Die Fehlerbehebung bleibt eine Kunst: Verstehen Sie das Symptom, verfolgen Sie es bis zur Ursache zurück und beheben Sie es, ohne etwas anderes zu brechen. Codex unterstützt alle drei Schritte, jedoch ungleichmäßig. Beim ersten Schritt fügt es fast nichts hinzu, da Sie selbst das Symptom beobachten und wissen, wie das System funktionieren sollte. Beim zweiten Schritt glänzt es, da das Zurückverfolgen eines Datenflusses durch zehn Dateien systematische Lesearbeit ist – genau das, was eine Maschine besser als ein müder Mensch leistet. Beim dritten Schritt bietet es sofortige Verifizierung durch Tests.
Fehlerbehebung ausgehend von einem Fehler
Der einfachste Fall: Sie übergeben den Fehler so, wie er ist, ohne ihn umzuformulieren oder zusammenzufassen.
"Der Test src/api/routes/orders.test.ts schlägt fehl mit:
TypeError: Cannot read properties of undefined
(reading 'id')
at createOrder (src/services/order.service.ts:42)
Finden Sie die Ursache und beheben Sie den Fehler."
Das Agenten-System führt dann sechs Operationen aus: Es liest die Testdatei, um das Szenario zu verstehen, öffnet order.service.ts an Zeile 42, verfolgt den Datenfluss, um zu finden, wo undefined eingeführt wurde, identifiziert die Ursache – fehlender Parameter, Typfehler oder etwas anderes –, schlägt eine Lösung vor und wendet sie an, und führt den Test erneut aus, um zu verifizieren. Die dritte Operation ist jene, die Ihnen zwanzig Minuten stilles Lesen gekostet hätte.
Fehlerbehebung bei unerwartetem Verhalten
Oft gibt es gar keinen Fehler: Das Programm tut stillschweigend etwas Falsches. Dies sind die teuersten Fehler, und hier ist es am wichtigsten, wie Sie Ihre Anfrage formulieren.
"Die POST /api/orders-Route erstellt die Bestellung in der
Datenbank, aber die Gesamtsumme ist immer 0. Die Produktpreise
sind in der products-Tabelle korrekt. Finden Sie, warum die
Berechnung der Gesamtsumme fehlschlägt."
Diese Anweisung funktioniert, weil sie den Umfang definiert: Was funktioniert, was nicht, und eine Hypothese, die bereits ausgeschlossen wurde, da die Preise in der Datenbank korrekt sind. Codex verfolgt dann den Fluss von der HTTP-Anfrage bis zur Einfügung, isoliert den Punkt, an dem die Berechnung aus dem Ruder läuft, und schlägt eine Lösung vor. Ohne den Satz über die products-Tabelle würde es höchstwahrscheinlich damit beginnen, genau das zu prüfen, was Sie selbst bereits geprüft haben.
Analyse von Produktionsprotokollen
Sie können auch von Produktionsverläufen ausgehen, indem Sie einfach den relevanten Auszug einfügen.
"Dies ist ein Auszug aus den Produktionsprotokollen. Die Anwendung
gibt intermittierend 500 auf /api/checkout zurück:
[2026-04-01 14:23:01] ERROR: Connection pool exhausted
[2026-04-01 14:23:01] WARN: Query timeout after 30s
[2026-04-01 14:23:02] ERROR: Transaction rollback
Analysieren Sie den Code der Checkout-Route und identifizieren Sie
den Datenbank-Verbindungsleck."
Codex verknüpft die drei Zeilen – erschöpfter Pool, Abfragezeitüberschreitung, Transaktions-Rollback –, schließt auf ein Datenbank-Verbindungsleck, und sucht dann im Code nach Stellen, an denen eine Verbindung geöffnet, aber nicht ordnungsgemäß geschlossen wird. Dies ist typischerweise ein Fehler, den kein Test aufdeckt, da er nur unter Last auftritt und verschwindet, sobald Sie versuchen, ihn lokal nachzuahmen.
Fehlerbehebung durch Halbierung
Wenn das Problem diffus statt auf einen Punkt hinweist, bitten Sie um eine methodische Untersuchung statt um eine schnelle Reparatur.
"Der TypeScript-Build-Vorgang schlägt fehl mit 23 Typfehlern seit
der letzten Abhängigkeitsaktualisierung. Analysieren Sie jeden
Fehler, identifizieren Sie, ob es sich um eine API-Änderung in
einer Abhängigkeit handelt, und passen Sie den Code an, um mit
den neuen Versionen kompatibel zu sein."
Der Wert dieser Formulierung besteht darin, dass sie eine Diagnose Fehler für Fehler erzwingt. Ohne die Anweisung, den Ursprung zu identifizieren, ist die Versuchung für ein Agenten-System – wie für einen Entwickler am Ende des Tages –, any hinzuzufügen, bis der Compiler still wird, was zwanzig drei sichtbare Fehler in zwanzig drei zukünftige Fehler verwandelt.
Effektive Muster der Fehlerbehebung
Das von Ihnen bereitgestellte Material bestimmt alles Weitere. Jeder Symptomtyp erfordert spezifische Beweise, die enthalten sein müssen, und deren Auslassen ist wie eine Diagnoseanfrage ohne Untersuchung.
| Symptom | Codex-Anweisung |
|---|---|
| Fehlgeschlagener Test | Vollständigen Fehlerbericht + Testdatei bereitstellen |
| Typfehler | Ausgabe von tsc --noEmit bereitstellen |
| Laufzeitfehler | Stapelablauf (Stack Trace) + Schritte zur Reproduktion bereitstellen |
| Falsches Verhalten | Erwartetes vs. beobachtetes Ergebnis beschreiben |
| Leistungsproblem | Metriken bereitstellen (Antwortzeit, langsame Abfragen) |
Verhinderung zukünftiger Fehler
Ein behobener Fehler ist nur zur Hälfte gelöst, wenn nichts verhindert, dass er an anderer Stelle wieder auftritt. Folgen Sie dem Fix daher systematisch mit einer Konsolidierungsaufgabe, formuliert aus dem, was Sie gerade gelernt haben.
"Der Fehler stammte von einer nicht geprüften null userId. Fügen Sie
Typ-Guards in allen Funktionen in src/services/ hinzu, die eine
userId empfangen. Fügen Sie zudem einen Regressionstest für diesen
Fall hinzu."
Diese zweite Aufgabe verallgemeinert die Lektion, bei der die Reparatur lokal blieb: Die Guards decken alle Services ab, und der Regressionstest stellt sicher, dass dieser spezifische Fall auch nach Ihrem Verlassen des Projekts überwacht bleibt. Dies ist der Schritt, der ein Team, das Fehler behebt, von einem Team unterscheidet, das seinen Backlog reduziert.
Kernaussagen
- Geben Sie Codex den maximalen Kontext: Fehlermeldungen, Stapelabläufe, Protokolle
- Codex verfolgt den Datenfluss, um die Ursache zu finden
- Es verifiziert seine Reparatur durch automatisches Neuausführen von Tests
- Nach der Reparatur bitten Sie um Schutzmaßnahmen und Regressionstests
- Je präziser Ihre Anweisungen sind, desto schneller ist die Fehlerbehebung