Arreglar un bug significa hacer que un defecto reproducible deje de reproducirse, y dejar la evidencia de que no volverá. La primera mitad es «cambiar el código». La segunda es «cerrarlo bien», y la mayoría de los equipos solo hace la primera, así que el mismo problema reaparece tres meses después por otra puerta. La calidad de una corrección no se mide por lo ingenioso del cambio. Se mide por si la próxima pasada de regresión, la próxima persona que herede el código y tú mismo dentro de tres meses podéis concluir, solo con el registro, que de verdad desapareció.
Este artículo trata únicamente «cómo corregir, cómo verificar, cómo cerrar». Qué bug corregir primero pertenece al triaje — ver la guía de triaje de defectos. Cómo escribir un informe que se pueda corregir está en qué debe contener un informe de bug.
El ciclo de seis pasos
Cada paso tiene un requisito mínimo de evidencia. Si no se cumple, retrocede un paso en lugar de avanzar: es la regla más útil de todo el artículo.
| Paso |
Qué haces |
Evidencia mínima |
Si no la tienes |
| 1 Leer |
Decidir si el informe se puede empezar |
URL, entorno (navegador / SO / versión), esperado frente a real |
Devuélvelo; no adivines |
| 2 Reproducir |
Provocar el problema una vez, tú mismo |
Una reproducción confirmada, o un «no reproducible» explícito |
Anota lo probado, aparca; nunca cierres |
| 3 Localizar |
Saber qué capa está mal |
Un error literal, una petición fallida o un resultado de bisección |
Deja de tocar código; añade observabilidad |
| 4 Corregir |
Eliminar la causa con el cambio más pequeño |
Un cambio, una causa |
Divide el commit |
| 5 Verificar |
Demostrar que está corregido y que nada más se rompió |
Mismo recorrido + casos límite + matriz de regresión |
«Parece bien» no es verificar |
| 6 Cerrar |
Hacerlo legible para la siguiente persona |
Una línea de causa raíz + un enlace a la evidencia |
«Corregido» a secas no es un cierre |
Paso 1: leer el informe y decidir si se puede empezar
Un informe arrancable tiene tres cosas: dónde, en qué entorno y en qué difiere lo real de lo esperado. Si falta cualquiera, la acción correcta es devolverlo, no abrir el código a echar un vistazo.
El coste del «echo un vistazo» se subestima mucho. Una parte notable de las páginas que un desarrollador deduce tras 40 minutos de conjeturas no es la que quien reportó tenía en mente. Una devolución cuesta dos minutos.
Paso 2: reproducir, o decir claramente que no puedes
La reproducción es la divisoria. Un defecto que se reproduce de forma fiable es solo cuestión de tiempo. Uno que no se reproduce convierte cualquier cambio en una apuesta.
Hay que fijar tres cosas al reproducir, o no estás reproduciendo el mismo defecto:
Estado de los datos. Qué cuenta, si hay caché de por medio, si queda basura antigua en localStorage.
Versión de la compilación. Bundle de front, commit de back, cualquier flag activo.
Secuencia de acciones. ¿Clic inmediato al cargar, tras unos segundos, tras cambiar de pestaña, con conexión lenta?
Si de verdad no se reproduce, anótalo como «no reproducible» junto con tres preguntas, en lugar de cerrarlo:
- ¿En qué página y por qué entrada estabas? (La URL original suele llevar parámetros.)
- ¿Está atado a una cuenta, un rol o un permiso concretos?
- ¿A qué hora ocurrió? (Si coincide con un log o un despliegue, tienes una pista.)
Paso 3: localizar — primero la capa
Las correcciones lentas no suelen ser problemas difíciles: son problemas buscados en la capa equivocada. Tres gestos lo reducen a una capa:
| Gesto |
Qué miras |
Qué descarta |
| Consola |
El error literal y la pila |
Descarta problemas «solo de estilos / solo de datos» |
| Panel de red |
Cualquier 4xx / 5xx y si los cuerpos de petición y respuesta cuadran |
Separa «el front nunca lo envió» de «el back devolvió algo incorrecto» |
| Bisección / rollback |
Qué versión o commit funcionaba la última vez |
Descarta «siempre fue así» |
Leer errores: niveles de log explicados y tipos de errores en programación. Abrir la consola: abrir la consola del navegador. Para perfiles no técnicos que quieren mirar primero: DevTools para no desarrolladores.
Un orden concreto: la API devuelve 500 → back. La API devuelve 200 pero un campo está mal → contrato. La API nunca se llamó → lógica o validación del front. La API está bien, la interfaz no → renderizado. Cuatro líneas cubren la mayor parte de lo que le pasa a un equipo web.
Paso 4: corregir con el cambio más pequeño
«El cambio más pequeño» no es prudencia, es verificabilidad. Una pull request que a la vez corrige el bug, refactoriza un módulo y sube una dependencia te impide decir cuál de las tres causó el siguiente problema, y eso hace imposible el paso 5.
Dos reglas:
- Un commit, una causa. Si encuentras un segundo problema mientras corriges, abre un ticket aparte.
- La refactorización tiene su propio tiempo. Hacerla durante una corrección mezcla riesgo conocido con riesgo desconocido.
Paso 5: verificar — demostrar que está corregido, no escondido
Aquí se separa este artículo de la mayoría de los textos de «cómo corregir bugs». Las cuatro prácticas siguientes hacen desaparecer el defecto mientras el problema sigue:
| Práctica |
Apariencia |
Realidad |
try / catch vacío |
El error ya no aparece |
La lógica posterior falla en silencio, los datos se escriben mal |
| Aflojar la validación |
No más errores |
Datos sucios entran en la base, se descubren meses después |
| Ocultar el punto de entrada |
El usuario ya no puede hacer clic |
La necesidad sigue, llega por otra vía, el comportamiento diverge |
| Un flag que nunca se vuelve a encender |
El síntoma no aparece |
El flag se convierte en código que nadie se atreve a borrar |
El único criterio válido: ¿puede el usuario hacer ahora lo que quería hacer? No «¿ha desaparecido el error?».
Verificar tiene tres partes:
Recorrer la ruta original — exactamente la que describe el informe, del primer paso al último.
Reprobar los bordes — valores vacíos, texto muy largo, emoji, zonas horarias, importes con decimales, una cuenta sin permisos. Ahí es donde vive la reincidencia.
Ejecutar la matriz de regresión — qué funcionalidad antigua pudo tocar este cambio, según cómo ejecutar pruebas de regresión.
Paso 6: cerrar con una línea de causa raíz
Cerrar un defecto con «corregido» traslada el coste a la siguiente persona. Una nota de causa raíz completa tiene tres partes:
text
Causa raíz: al confirmar el pedido, el formulario se vaciaba antes de enviar
la petición, así que una petición fallida dejaba el formulario
vacío; el reintento enviaba datos vacíos, recibía un 500 y un
catch silencioso se lo tragaba.
Corrección: enviar primero y vaciar al recibir éxito; se eliminó el catch
silencioso y se muestra un mensaje de error.
Verificado: Chrome 141 / macOS 14, tres reintentos con la red cortada
mostraron «No se pudo enviar, inténtalo de nuevo» y conservaron
el contenido; regresión: checkout, cupones, libreta de direcciones.
Esas tres partes responden «por qué estaba mal», «qué cambió» y «cómo lo demostraste». Sobreviven al diff — seis meses después el diff se ha reescrito, el archivo se ha dividido, el módulo se ha sustituido, y el comentario sigue ahí.
No dejes la evidencia solo en el chat. Capturas, grabaciones y peticiones fallidas deben vivir con el registro, o dentro de tres meses, cuando falle la regresión, «cómo se veía entonces» llevará a un enlace muerto. La extensión de BugCapturer adjunta errores de consola, peticiones fallidas, URL, navegador y viewport al enviar y genera un enlace compartible; en el plan de equipo los informes se conservan a largo plazo, por una razón simple: que «el informe original todavía abre» siga siendo cierto dentro de tres meses.
Por qué falla la reproducción: tres causas reales
«No reproducible» es un agujero negro en un gestor de defectos. Rara vez es suerte; es una de tres diferencias.
1. Entorno. Las cinco habituales: versión de compilación (en local corre el último main), cachés (navegador, service worker, CDN), feature flags, roles y permisos, zona horaria e idioma. El gesto es alinear esos cinco uno por uno, no pedir que lo intente otra vez.
2. Datos. El registro del usuario tiene una nota de 300 caracteres, un apodo con emoji, un segundo nombre null, un importe negativo. La interfaz siempre es correcta con «datos normales». Quien reproduce suele tener el ID del registro concreto.
3. Tiempo. Carreras asíncronas, carga diferida, debounce, orden de callbacks de terceros. Nunca aparecen con red rápida y siempre con red lenta; en la máquina del desarrollador siempre van bien. La herramienta es limitar el ancho de banda y añadir retardo, no más logs.
Cuando no puedas reproducir, anótalo como aparcado + lista de condiciones ya probadas + tres preguntas (entrada / cuenta / hora). Cerrarlo es la peor opción: pierdes la información de que ocurrió, y volverá.
Patch, hotfix, corrección normal: tres ritmos que no se mezclan
El mismo bug toma una de tres rutas según impacto y urgencia, no según dificultad:
| Corrección normal |
Patch |
Hotfix |
| Situación |
No bloquea el flujo principal, puede esperar |
Alcance pequeño pero debe salir pronto |
Producción caída / dinero en riesgo / seguridad |
| Proceso |
Iteración normal con revisión |
Sale con la siguiente versión menor |
Salta el proceso normal, se revisa después |
| Obligatorio extra |
Matriz de regresión |
Matriz + nota de cambio |
Matriz + nota de cambio + postmortem |
| Lo que más se olvida |
Verificación de casos límite |
Avisar a los usuarios afectados |
Corregir el síntoma y no la causa |
El riesgo del hotfix no es la velocidad, es que nadie vuelve después. Los cambios provisionales se quedan en el código, la regresión nunca se añade, el postmortem nunca se escribe. Un hotfix debe dejar tres cosas: una nota de versión, una pasada de regresión dirigida y una frase sobre cómo llegó eso a producción. Las notas de versión viven en el changelog.
Cinco reglas para el equipo
Si solo te llevas cinco:
Devuelve el informe que no se puede empezar; no adivines. Dos minutos de devolución frente a cuarenta de conjeturas.
Un commit, una causa. Un cambio mezclado no se verifica ni se revierte.
Cierra con causa raíz y enlace a la evidencia. La única regla que le ahorra un día a alguien, seis meses después.
«No reproducible» es motivo de aparcar, no de cerrar.
Una corrección sin rellenar la matriz no está terminada. La fila que omitiste es la entrada del próximo incidente.
La frontera entre defecto, requisito, error y bug se difumina — ver bug vs defect vs issue vs error. Si lo que necesitas es «cómo decírselo al cliente», ver compartir informes de errores con clientes.
Preguntas frecuentes
¿Cómo priorizo las correcciones frente a funcionalidades nuevas?
Por impacto por frecuencia, no por quién grita más. La matriz de gravedad por prioridad está en la guía de triaje. Un añadido: no reordenes la cola a mitad del sprint. Los equipos que re-trian constantemente suelen no terminar ninguna de las dos vías.
¿Puedo corregir varios bugs en un mismo cambio?
Solo con una única causa y un único punto — una causa con tres síntomas sigue siendo un bug. Causas independientes en el mismo commit hacen imposible revertir: cuando producción falla, solo puedes deshacer todo.
¿Cada bug necesita un test unitario?
No. Tres tipos lo merecen: los que reinciden (con historial de regresión), los de lógica ramificada (muchos casos límite) y cualquier cosa que calcule datos (importes, ratios, fechas). Lo puramente visual y los cambios de texto quedan cubiertos por el recorrido de regresión.
Encontré otro problema mientras corregía. ¿Lo arreglo también?
No. Abre un ticket aparte. Mezclarlo invalida el paso 5: no puedes decir qué cambio hizo desaparecer el problema.
¿Debemos avisar a los usuarios tras un bug en producción?
Si se vieron afectados datos enviados, importes o estados de pedido, avisa de forma proactiva y di qué se reparó. Si fue una indisponibilidad breve ya resuelta, basta una actualización de estado. Dejarlo en el changelog resuelve además el «¿hay algún registro?» cuando un cliente pregunta.