Foutopsporing met AI-ondersteuning
Op deze pagina
Vind en los bugs sneller op
Foutopsporing blijft een vak: begrijp het symptoom, traceer het terug naar de oorzaak en los het op zonder iets anders te breken. Codex helpt bij alle drie de stappen, maar in wisselende mate. Bij de eerste stap voegt het bijna niets toe, omdat u degene bent die het symptoom observeert en weet wat het systeem zou moeten doen. Bij de tweede stap blinkt het uit, omdat het traceren van een datastroom door tien bestanden systematisch leeswerk is—precies wat een machine beter doet dan een vermoeide mens. Bij de derde stap biedt het directe verificatie via tests.
Foutopsporing vanuit een foutmelding
Het meest voor de hand liggende geval: u geeft de foutmelding letterlijk door, zonder deze te herformuleren of samen te vatten.
"The test src/api/routes/orders.test.ts fails with:
TypeError: Cannot read properties of undefined
(reading 'id')
at createOrder (src/services/order.service.ts:42)
Find the cause and fix the bug."
De agent koppelt vervolgens zes bewerkingen aan elkaar: het leest het testbestand om het scenario te begrijpen, opent order.service.ts op regel 42, traceert de datastroom om te vinden waar undefined is geïntroduceerd, identificeert de oorzaak—ontbrekende parameter, typefout of iets anders—, stelt de oplossing voor en past deze toe, en voert de test opnieuw uit ter verificatie. De derde bewerking is degene die u twintig minuten stil lezen had gekost.
Foutopsporing bij onverwacht gedrag
Vaak is er helemaal geen foutmelding: het programma doet stiekem iets verkeerd. Dit zijn de duurste bugs, en juist hier maakt de formulering van uw verzoek het grootste verschil.
"The POST /api/orders route creates the order in the
database, but the total is always 0. Product prices are
correct in the products table. Find why the total
calculation fails."
Deze instructie werkt omdat het de scope definieert: wat werkt wel, wat niet, en één hypothese die al is uitgesloten omdat de prijzen in de database correct zijn. Codex traceert vervolgens de stroom van het HTTP-verzoek tot de insertie, isoleert waar de berekening misgaat, en stelt een oplossing voor. Zonder de zin over de products-tabel zou het waarschijnlijk beginnen met het controleren van precies datgene wat u zojuist zelf al hebt gecontroleerd.
Analyse van productielogbestanden
U kunt ook beginnen met productietraces, simpelweg door het relevante fragment te plakken.
"Here's an excerpt from production logs. The application
intermittently returns 500 on /api/checkout:
[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
Analyze the checkout route code and identify the connection
leak."
Codex legt het verband tussen de drie regels—pool uitgeput, query time-out, transactie teruggedraaid—, concludeert dat er sprake is van een lek in de databaseverbinding, en zoekt in de code naar plekken waar een verbinding wordt geopend maar niet correct gesloten. Dit is doorgaans een bug die door geen enkele test wordt blootgelegd, omdat deze alleen onder belasting optreedt en verdwijnt zodra u lokaal probeert deze te reproduceren.
Foutopsporing via bisection
Wanneer het probleem diffuus is in plaats van gelokaliseerd, vraagt u om een methodisch onderzoek in plaats van een snelle oplossing.
"The TypeScript build fails with 23 type errors since the
last dependency update. Analyze each error, identify whether
it's an API change in a dependency, and fix the code to be
compatible with the new versions."
De waarde van deze formulering is dat het een diagnose per fout afdwingt. Zonder de instructie om de oorsprong te identificeren, is de verleiding voor een agent—net als voor een ontwikkelaar aan het eind van de dag—om overal any toe te voegen totdat de compiler stilvalt, wat drieëntwintig zichtbare fouten omzet in drieëntwintig toekomstige bugs.
Effectieve patronen voor foutopsporing
Het materiaal dat u aanlevert, bepaalt alles. Elk type symptoom vraagt om specifiek bewijsmateriaal om op te nemen; het weglaten ervan is alsof u om een diagnose vraagt zonder onderzoek.
| Symptoom | Codex-instructie |
|---|---|
| Mislukte test | Geef de volledige foutmelding + het testbestand |
| Type-fout | Geef de uitvoer van tsc --noEmit |
| Runtime-fout | Geef de stack trace + stappen om te reproduceren |
| Onjuist gedrag | Beschrijf het verwachte versus het waargenomen resultaat |
| Prestatieprobleem | Geef metrics (responstijd, trage queries) |
Voorkom toekomstige bugs
Een opgeloste bug is slechts voor de helft afgehandeld als niets voorkomt dat deze elders opnieuw optreedt. Laat daarom systematisch een consolidatietaak volgen op de oplossing, geformuleerd op basis van wat u zojuist hebt geleerd.
"The bug came from an unchecked null userId. Add type
guards in all functions in src/services/ that receive a
userId. Also add a regression test for this case."
Deze tweede taak generaliseert de les waar de oplossing lokaal bleef: de guards dekken alle services, en de regressietest zorgt ervoor dat dit specifieke geval onder toezicht blijft nadat u het project hebt verlaten. Dit is de zet die een team onderscheidt dat bugs oplost van een team dat zijn achterstand verkleint.
Belangrijkste punten
- Geef Codex de maximale context: foutmeldingen, stack traces, logbestanden
- Codex traceert de datastroom om de oorzaak te vinden
- Het verifieert de oplossing door tests automatisch opnieuw uit te voeren
- Vraag na het oplossen om beschermingsmaatregelen en regressietests
- Hoe preciezer uw instructies, hoe sneller de foutopsporing