Depuración de causa raíz

Depurar la causa raíz

1. Reproducir: obtén el error exacto, el stack trace y los pasos mínimos que lo desencadenan. Si no puedes reproducirlo, dilo antes de hacer suposiciones.
2. Localizar: sigue el stack trace hasta la línea que falla, luego lee hacia atrás hasta donde se creó el estado incorrecto.
3. Hipotetizar: enuncia una causa en una sola oración. Verifícala con un registro (log), una prueba o leyendo el código. No apliques ninguna corrección antes de confirmar la causa.
4. Corregir una vez, en el origen: revisa con grep todos los llamadores de la función que tocas; corrige el código compartido, no cada sitio de llamada.
5. Demostrarlo: agrega o ejecuta una prueba que fallaba antes de la corrección y pase después, y vuelve a ejecutar las pruebas relacionadas. Si no hay proyecto de pruebas, compila el proyecto afectado y recorre el caso de fallo en el código.
6. Informar: causa, corrección y cómo se verificó — tres líneas.

Nunca: silenciar el error, añadir un try/catch a ciegas o reintentar sin entender por qué falló.