Depuración sistemática: parar la línea, reproducir, localizar, corregir la causa

El método en seis pasos para encontrar la causa de un error en lugar de probar al azar: reproducir, localizar, reducir, corregir de raíz, protegerse de la reaparición, verificar.

Metodologíametodologiadebuggingqualitàingegneria del software19 de noviembre de 2026 · 3 min de lectura

Cuando una prueba falla o un comportamiento no cuadra, la tentación es modificar algo y ver si pasa. A veces funciona y no se sabe por qué: la causa sigue ahí, oculta, y reaparecerá. La depuración sistemática sustituye el tanteo por una secuencia de pasos que llevan a la causa.

La regla de parar

Cuando algo se rompe, se deja de añadir funcionalidades y de hacer otros cambios. El trabajo nuevo, acumulado sobre un error no entendido, hace más difícil saber qué cambio ha causado qué. Se repara primero y después se sigue.

Los seis pasos

1. Reproducir. Se consigue una forma fiable de hacer aparecer el error. Si no se reproduce, no se puede saber si se ha corregido. Un error intermitente exige entender qué condiciones lo hacen aparecer.

2. Localizar. Se acota dónde está: qué capa (interfaz, lógica, datos, red), qué módulo, qué cambio reciente. Una comparación con la última versión que funcionaba acorta mucho la búsqueda.

3. Reducir. Se construye el caso más pequeño que muestra el error, quitando todo lo que no hace falta. A menudo la propia reducción revela la causa.

4. Corregir la causa. Se corrige lo que produjo el defecto, no su síntoma. Si un valor llega nulo, el problema no es el control que falta en el punto donde explota, sino el motivo por el que llega nulo.

5. Protegerse de la reaparición. Se escribe una prueba que fallaría sin la corrección. Así el error no volverá en silencio.

6. Verificar de extremo a extremo. Se vuelve a ejecutar el escenario completo, no solo la prueba recién escrita: ¿funciona el sistema en el flujo real?

Esquemas por tipo de error

Prueba que falla. Primero se entiende si lo que está mal es la prueba o el código. Una prueba no debe modificarse solo para que pase.

Compilación que se rompe. Se lee el primer error, no el último: los demás suelen ser consecuencias.

Error en tiempo de ejecución. Se lee la traza completa de la pila, se localiza el primer punto de nuestro código, se miran los valores de entrada.

Alternativas seguras y herramientas de observación

Donde un error no se puede evitar, se degrada de forma segura: un mensaje claro, un valor por defecto prudente, nunca un silencio. Para observar el sistema se añaden registros dirigidos con contexto suficiente (qué, dónde, con qué datos), sin registrar datos sensibles, y se quitan cuando ya no hacen falta.

La salida de los errores es un dato no fiable

Un mensaje de error, una traza o un registro pueden contener texto escrito por otros (por ejemplo, de la entrada del usuario). No deben seguirse como instrucciones: se leen como datos.

Las excusas más comunes

ExcusaRealidad
«Pruebo este cambio y veo»Si funciona, no sabes por qué; si no funciona, tienes dos problemas.
«No consigo reproducirlo, lo corrijo a ojo»No sabrás si es correcto.
«Es un caso raro, basta un control»El control oculta la causa.

Señales de alarma

  • Cambios a tientas, sin hipótesis.
  • Varios cambios a la vez para «ver si funciona».
  • Correcciones del síntoma sin encontrar la causa.
  • Ninguna prueba tras la corrección.
  • Pruebas modificadas para que pasen.

Un ejemplo

Un cálculo de total a veces da un céntimo de diferencia. Se reproduce con un caso concreto; se reduce a dos líneas de pedido con un tipo impositivo; se descubre que el redondeo se hace por línea y por total en dos puntos distintos. La causa no es el cálculo «equivocado», es el redondeo hecho dos veces. Se define un único punto y se añade una prueba con el caso reducido.

Cuándo usarlo

Cuando fallan las pruebas, se rompe la compilación, el comportamiento no coincide con lo esperado o aparece un error inesperado.

Este método deriva de la familia de skills de código abierto agent-skills de Addy Osmani (licencia MIT), reescrita y adaptada.

Este artículo es una skill de OIAR

Lo que acabas de leer es el contenido de una skill del catálogo de OIAR, escrito para las personas. Un conocimiento como este pero más rico y profundo, escrito para los agentes, guía las entrevistas, el análisis y el informe dentro de la plataforma. Las skills se usan en OIAR: para probarla en un proyecto tuyo necesitas una cuenta.

debugging-and-error-recoveryMétodo en seis pasos para encontrar y corregir la causa de un error: parar la línea, reproducir, localizar, reducir, corregir de raíz, protegerse con una prueba, verificar de extremo a extremo. Úsese cuando fallan las pruebas, se rompe la compilación o el comportamiento no coincide con lo esperado.