bug-debugger

Bug Debugger

Étape 0 — Collecter le contexte minimal

Avant toute hypothèse, s'assurer d'avoir :

Info	Exemples
Message d'erreur complet	stack trace, code HTTP, errno
Comportement attendu vs observé	"devrait retourner 200, retourne 500"
Reproductibilité	toujours / parfois / en prod seulement
Dernière modification	commit, déploiement, changement config
Environnement	OS, version runtime, variables d'env

Si un de ces éléments manque et bloque le diagnostic → demander uniquement ce qui est nécessaire, pas tout à la fois.

---

Étape 1 — Lire l'erreur sans sauter aux conclusions

TypeError: Cannot read properties of undefined (reading 'id')
    at getUserName (user.js:42:18)
    at processRequest (api.js:17:5)

• Lire le type d'erreur : TypeError, NullReferenceException, SIGSEGV…
• Localiser le premier frame applicatif (ignorer les frames de libs tierces).
• Identifier l'opération qui échoue : accès propriété, appel fonction, cast, IO…

---

Étape 2 — Formuler 3 hypothèses classées par probabilité

Format attendu :

1. (Probable) user est undefined car la DB ne retourne rien pour cet ID → vérifier avec console.log(user) avant la ligne 42.
2. (Possible) La fonction est appelée avant que la promesse soit résolue → ajouter await.
3. (Moins probable) Race condition sur un cache partagé → vérifier si ça arrive en parallèle.

Règle : ne pas proposer plus de 3 hypothèses sans validation intermédiaire.

---

Étape 3 — Vérification rapide par hypothèse

JavaScript/TypeScript

// Inspecter sans modifier le flux
console.log('[debug] user:', JSON.stringify(user, null, 2));
// Vérifier le type exact
console.log('[debug] typeof user:', typeof user, user instanceof Object);

Python

import pprint
print('[debug] user:', pprint.pformat(user))
# Ou avec breakpoint natif (Python 3.7+)
breakpoint()

.NET / C#

// Ajouter un point de log avant la ligne incriminée
_logger.LogDebug("user={User}", JsonSerializer.Serialize(user));
// Ou utiliser le debugger avec Watch sur l'expression